Designer de Skills

Design de Skills (Skill Designer)

Visão Geral

Gere um prompt abrangente para a CLI Claude a partir de uma especificação estruturada de ideia de skill. O prompt instrui o Claude a criar um diretório completo de skill seguindo as convenções do repositório: SKILL.md com frontmatter YAML, documentos de referência, scripts auxiliares e andaimes de teste.

Quando Usar

• O pipeline de geração automática de skills seleciona uma ideia do backlog e precisa de um prompt de design para claude -p
• Um desenvolvedor quer iniciar uma nova skill a partir de uma especificação de ideia em JSON
• A revisão de qualidade de skills geradas requer conhecimento da rubrica de pontuação

Pré-requisitos

• Python 3.9+
• Nenhuma chave de API externa necessária
• Os arquivos de referência devem existir em references/

Fluxo de Trabalho

Etapa 1: Preparar Especificação da Ideia

Aceite um arquivo JSON (--idea-json) contendo:

• title: Nome legível da ideia
• description: O que a skill faz
• category: Categoria da skill (ex.: trading-analysis, developer-tooling)

Aceite um nome de skill normalizado (--skill-name) que será usado como nome do diretório e campo name: do frontmatter YAML.

Etapa 2: Construir o Prompt de Design

Execute o construtor de prompt:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

O script:

1. Carrega o JSON da ideia
2. Lê todos os três arquivos de referência (guia de estrutura, checklist de qualidade, template)
3. Lista as skills existentes (até 20) para evitar duplicação
4. Gera um prompt completo para a saída padrão

Etapa 3: Alimentar o Prompt para a CLI Claude

O pipeline de chamada redireciona o prompt para claude -p:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

Etapa 4: Validar a Saída

Após o Claude criar a skill, verifique:

• skills/<nome-da-skill>/SKILL.md existe com frontmatter correto
• A estrutura do diretório segue as convenções
• A pontuação com o revisor de eixos duais atende ao limite

Formato de Saída

O script gera um prompt em texto simples para a saída padrão. Código de saída 0 em caso de sucesso, 1 se os arquivos de referência necessários estiverem faltando.

Recursos

• references/skill-structure-guide.md -- Estrutura de diretório, formato SKILL.md, convenções de nomenclatura
• references/quality-checklist.md -- Checklist de 5 categorias do revisor de eixos duais (100 pontos)
• references/skill-template.md -- Template SKILL.md com frontmatter YAML e seções padrão
• scripts/build_design_prompt.py -- Script construtor de prompt (interface CLI)