Claude Toad
junianwoo/claude-toad
Configure seu Claude Code inteiro com um comando. Automático.
Ver no GitHubSkill 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-toad1 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
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
| File | What it does |
|---|---|
CLAUDE.md | Your project in under 150 lines. Stack, architecture, commands, conventions, gotchas. |
skills/*.md | Deep knowledge for your specific framework, database, and testing setup. Loaded only when relevant. |
agents/*.md | Code reviewer and PR writer that know your language and standards. |
commands/*.md | Slash commands for test, deploy, and whatever else your project needs. |
settings.json | Permissions and hooks. Sensible defaults. No dangerously-skip-permissions. |
.mcp.json | MCP 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
- Node.js 18+
- Anthropic API key (console.anthropic.com)
- Smidge API key for
add-skillonly (smdg.app/account)