convez.ai
SkillAutomaçãoIntermediário
ban10yuu

Agent Skill Smith

ban10yuu/agent-skill-smith

Crie skills reutilizáveis para agentes de IA em segundos

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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-smith

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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

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.
  • name is present.
  • description explains 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

  • pack command for sharing a skill folder.
  • doctor command 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

Ver o original no GitHub

Bom para

Relacionados