Agent Skill Smith
ban10yuu/agent-skill-smith
Crie skills reutilizáveis para agentes de IA em segundos
Ver no GitHubFerramenta CLI para gerar e validar pastas de skills portáveis para agentes de IA (Claude Code, Cursor, Gemini CLI e similares). Transforma prompts repetitivos em workflows reutilizáveis estruturados com triggers, instruções, exemplos e checklist de verificação.
Instalação
npx convez-ai ban10yuu/agent-skill-smith1 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
- Documentar workflows repetitivos para agentes de código
- Criar guias estruturados de auditoria (SEO, revisão de código, design)
- Manter consistência de skills em repositórios multi-agente
- Gerar templates com YAML frontmatter e seções obrigatórias
Veredito

Solução prática para quem usa agentes de IA em fluxos de trabalho. Sem dependências externas, sem telemetria, focada em portabilidade e validação estruturada de skills. Ainda em alfa, mas funcional para organizar prompts complexos em formato reutilizável.
README
A tradução para o português deste README ainda está na fila.
agent-skill-smith
Generate and validate portable AI-agent skill folders for Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and similar coding agents.
If you keep repeating the same long prompt, turn it into a reusable SKILL.md folder.
npx agent-skill-smith init seo-auditor
npx agent-skill-smith check seo-auditor
No API key. No telemetry. No framework.
Why this exists
Agent skills are becoming the easiest way to package repeatable AI workflows:
- how to review a codebase
- how to write a launch plan
- how to audit SEO
- how to run a project-specific verification loop
- how to keep an agent from skipping important steps
The hard part is not writing Markdown. The hard part is remembering the shape that makes a skill useful: triggers, workflow, examples, and verification.
agent-skill-smith gives you that shape in one command.
Install
Use it directly:
npx agent-skill-smith --help
Before the npm package is published, run it from GitHub:
npx github:ban10yuu/agent-skill-smith --help
npm exec --yes --package github:ban10yuu/agent-skill-smith#main -- agent-skill-smith --help
Or install globally:
npm install -g agent-skill-smith
Quick demo
agent-skill-smith init launch-reviewer
Creates:
launch-reviewer/
SKILL.md
README.md
examples/
usage.md
Preview a skill without writing files:
agent-skill-smith print launch-reviewer
Validate a skill folder:
agent-skill-smith check launch-reviewer
Expected output:
OK /path/to/launch-reviewer/SKILL.md
Commands
init
Create a new skill folder.
agent-skill-smith init seo-auditor
agent-skill-smith init seo-auditor --dir ./skills
agent-skill-smith init seo-auditor --dir ./skills --force
--force overwrites generated files.
check
Validate an existing skill folder.
agent-skill-smith check ./skills/seo-auditor
It checks:
- YAML frontmatter starts the file.
nameis present.descriptionexplains when to use the skill.- Required sections exist.
- The skill includes trigger guidance.
- The skill includes a verification step.
print
Print the generated SKILL.md to stdout.
agent-skill-smith print seo-auditor
Useful when you want to pipe or inspect the template first.
Generated SKILL.md shape
---
name: seo-auditor
description: "Use when a user needs a repeatable SEO Auditor workflow for AI coding agents."
---
# SEO Auditor
## When To Use
## Trigger Phrases
## Workflow
## Quality Checklist
## Example Prompts
Who should use it
- You build with Claude Code, Codex, Cursor, OpenCode, Gemini CLI, or other coding agents.
- You want reusable workflows instead of one-off prompts.
- You maintain an agent-ready repo and want skill folders that look consistent.
Development
npm install
npm run check
Run a local smoke test:
npm run build
node dist/src/cli.js init seo-auditor --dir /tmp/agent-skill-smith-demo --force
node dist/src/cli.js check /tmp/agent-skill-smith-demo/seo-auditor
Roadmap
packcommand for sharing a skill folder.doctorcommand for stronger wording suggestions.- Presets for common skills: code review, SEO audit, design review, launch checklist.
- Compatibility notes for more agent surfaces.
Status
Alpha. The CLI is usable today, but the generated skill template will keep tightening as agent skill conventions settle.
License
MIT