convez.ai
SkillProdutividadeIntermediário
costrict-plugins-repo

Write-a-Skill

costrict-plugins-repo/alirezarezvani-claude-code-skills-write-a-skill

Framework estruturado para escrever skills de qualidade com validação automática

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para criar novas agent skills com estrutura apropriada, divulgação progressiva e recursos agrupados. Implementa o workflow 3-fase (Gather → Draft → Review) de Matt Pocock com validadores Python que operacionalizam checklist de qualidade, referências estruturadas e persona interrogativa para força de autoria.

Instalação

$npx convez-ai costrict-plugins-repo/alirezarezvani-claude-code-skills-write-a-skill

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
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Estruturar novas skills com padrão consistente
  • Validar qualidade de descrições e estrutura de skills existentes
  • Operacionalizar checklist de review durante criação de skills
  • Onboarding de skill authors com exemplos e referências progressivas

Veredito

Recurso bem pensado que leva a sério a governança de skills — traz ferramentas de validação Python e referências estruturadas sobre o que faz uma skill legível. Útil para times que precisam de consistência na autoria de skills, embora demande compreensão prévia do modelo de skills do Claude.

README

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

write-a-skill

Skill-author skill: create new agent skills with proper structure, progressive disclosure, and bundled resources.

Attribution

Derived from Matt Pocock's write-a-skill (MIT-licensed). Matt's skills repo — "Skills for Real Engineers. Straight from my .claude directory" — is the original source. Matt's SKILL.md voice + 3-phase workflow (Gather → Draft → Review) preserved verbatim per his MIT license.

What this adds on top of Matt's original

AdditionWhereWhy
3 stdlib Python validation toolsskills/write-a-skill/scripts/Operationalize Matt's review checklist (description validator, structure validator, review-checklist runner). Catches the common mistakes Matt names.
3 in-depth references (5+ sources each)skills/write-a-skill/references/Progressive disclosure principles · Description design patterns · Quality gates for skills. Cites Anthropic skill docs + community precedent + research.
cs-skill-author persona agentagents/cs-skill-author.mdSurface skill-authoring as a forcing-question interrogation matching our cs-* persona pattern.
/cs:write-a-skill slash commandcommands/cs-write-a-skill.md6-question forcing interrogation that runs Matt's review checklist programmatically.

What Matt's original brings (preserved)

  • The 3-phase workflow: Gather → Draft → Review
  • The non-negotiable description rule: "The description is the only thing your agent sees when deciding which skill to load."
  • The 100-line SKILL.md ceiling + progressive-disclosure pattern (REFERENCE.md / EXAMPLES.md / scripts)
  • The good-example vs bad-example contrast for description writing
  • The 6-item review checklist
  • Matt's directness — no fluff, concrete patterns

Quick start

# Run Matt's review checklist on an existing skill
python skills/write-a-skill/scripts/skill_review_checklist_runner.py path/to/SKILL.md

# Validate description meets Matt's criteria (≤1024 chars, third person, "Use when" trigger)
python skills/write-a-skill/scripts/skill_description_validator.py path/to/SKILL.md

# Validate skill folder structure
python skills/write-a-skill/scripts/skill_structure_validator.py path/to/skill-folder/

All three tools run with embedded samples if no path provided.

License

MIT (matching Matt's upstream).

Ver o original no GitHub

Bom para

Relacionados