convez.ai
SkillProdutividadeIntermediário
junianwoo

Claude Toad

junianwoo/claude-toad

Configure seu Claude Code inteiro com um comando. Automático.

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que escaneia seu projeto e gera automaticamente toda a estrutura .claude/ com um único comando. Analisa seu stack (Next.js, React, Django, etc), lê configurações e gera CLAUDE.md, skills, agents e commands customizados para seu projeto específico usando a API Claude.

Instalação

$npx convez-ai junianwoo/claude-toad

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 8 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Configurar Claude Code para projetos existentes sem reescrever CLAUDE.md
  • Gerar skills e agents específicos do seu framework e stack
  • Compartilhar configurações de Claude Code entre membros do time via package
  • Criar skills a partir de documentação, vídeos e PDFs do projeto

Veredito

Ferramenta bem pensada que resolve um pain point real: configurar Claude Code manualmente é tedioso e repetitivo. O claude-toad automatiza inteligentemente, gerando contexto específico do projeto sem bloat. Excelente para times que querem onboarding rápido com Claude Code.

README

A tradução para o português deste README ainda está na fila.

Claude Toad

Scans your project. Generates your entire .claude/ directory. One command.

npx claude-toad init

Why this exists

I was getting tired of rewriting my CLAUDE.md and still never sure I was doing it right. Every new Claude Code session starts from zero, and without a solid config, I'd end up repeating myself or watching it make assumptions I'd already corrected. I've also heard from others it took them months to get their configs right. So I built Claude Toad.

Claude Toad reads your repo, figures out what you're working with, calls Claude API (your key, your tokens), and generates the whole .claude/ directory. You get a configuration built from what's actually in your project.


What it looks like

Then you open Claude Code and it just... knows.


How it works

Step 1: Scan. Reads your package.json, tsconfig, prisma schema, test configs, CI setup, README, directory structure. No AI. Pure file system reads. Fast.

Step 2: Generate. Sends the project fingerprint to Claude's API. Your key, your tokens. Four focused API calls on Opus. Each call has one job: CLAUDE.md, skills, agents, then commands and hooks. Focused calls produce better output than asking one call to do everything.

Step 3: Write. Drops everything into .claude/. Every file tagged # Generated by Claude Toad - Review before use. You're in control.


Four commands

init

Point it at an existing project. It scans, generates, writes.

npx claude-toad init

new

Start a fresh project with Claude Code configured from the first commit. Interactive setup: pick your stack, your services, your conventions.

npx claude-toad new

package

Bundle your .claude/ directory into an installable plugin. One person configures, everyone on the team installs.

npx claude-toad package
npx claude-toad install my-team-config.zip

add-skill

Turn your own material into skills. Accepts YouTube videos, PDFs, docs, URLs, audio files. Integrates with Smidge for generation.

npx claude-toad add-skill --from "https://youtube.com/watch?v=..."
npx claude-toad add-skill --from "./docs/api-guide.pdf"

Requires a Smidge API key (prompted on first use).


What you get

FileWhat it does
CLAUDE.mdYour project in under 150 lines. Stack, architecture, commands, conventions, gotchas.
skills/*.mdDeep knowledge for your specific framework, database, and testing setup. Loaded only when relevant.
agents/*.mdCode reviewer and PR writer that know your language and standards.
commands/*.mdSlash commands for test, deploy, and whatever else your project needs.
settings.jsonPermissions and hooks. Sensible defaults. No dangerously-skip-permissions.
.mcp.jsonMCP servers for the services you actually use. Nothing you don't.

Supported stacks

Next.js (App Router + Pages), React, Remix, SvelteKit, Astro, Nuxt, Express, Fastify, NestJS, Hono, FastAPI, Django, Flask, Go, Rails, Rust.

More coming. Adding a framework takes one PR.


Flags

All flags apply to the init command:

claude-toad init --dry-run       See what would be generated without writing anything.
claude-toad init --model sonnet  Use Sonnet instead of the default (Opus).
claude-toad init --force         Skip confirmation prompts.
claude-toad init --verbose       Show the full project scan.
claude-toad init --no-agents     Skip agent generation.
claude-toad init --no-mcp        Skip MCP configuration.
claude-toad init --api-key KEY   Pass key directly (for CI/scripts).

Setup

Run without installing:

npx claude-toad init

Or install globally:

npm install -g claude-toad
claude-toad init

First run asks for your Anthropic API key. Stored locally at ~/.claude-toad/config.json. Never sent anywhere except directly to Anthropic's API. If you already have ANTHROPIC_API_KEY set, Claude Toad picks it up automatically.


Custom skills

The add-skill command integrates with Smidge to generate skills from source material. YouTube videos, PDFs, documentation, audio, raw text. Smidge handles the extraction and formatting so the output works across Claude Code and other AI coding tools.

You'll need a Smidge account and API key. Generate one from your account page. The CLI prompts you the first time.


Team config

# One person configures
npx claude-toad init
# Tweak it. Then:
npx claude-toad package

# Everyone else
npx claude-toad install team-config.zip

Open source

MIT License. BYOK. Runs locally. No telemetry. No analytics. No phoning home.

Your API key goes to Anthropic and nowhere else. Your code never leaves your machine.


Contributing

I'd like framework detectors. If Claude Toad doesn't recognize your stack, add it. One file, one PR.

Also welcome: prompt improvements, bug fixes, documentation.


Requirements


Ver o original no GitHub

Bom para

Relacionados