Meta-Criador de Skills
Use esta skill para transformar fluxos de trabalho repetíveis em pacotes de skill executáveis, validáveis e portáteis. O produto não é um "prompt mais longo", mas sim um pacote de capacidades com uma entrada padrão leve, detalhes carregados sob demanda e métodos de verificação reproduzíveis.
Contrato Central
- Partir do fluxo de trabalho real do usuário, nunca de templates de preferência pessoal.
- Antes de escrever qualquer arquivo, provar que o fluxo de trabalho merece ser transformado em skill; tarefas únicas não devem ser forçadas a se tornar um pacote de skill.
SKILL.mddeve conter apenas a face de roteamento: gatilho, primeira ação, carregamento progressivo, parada forçada e validação.- Pesquisa detalhada, design de produto, plano de pacote, avaliação de gatilho, método de aceitação e templates devem ser colocados em
references/,assets/,evals/,scripts/. - Skills que precisam complementar intenções ambíguas, permitir que o usuário faça múltiplas escolhas ou primeiro travar o MVP e depois gerar em lote, devem projetar faces de decisão nativas do host, como
request_user_inputdo Codex /AskUserQuestiondo Claude Code; cartões de escolha em Markdown são apenas interfaces de espera degradadas, não podem se passar por confirmação real. - Imagens, vídeos, apresentações, documentos, relatórios, dashboards ou outros artefatos renderizados devem priorizar verificação via Image2 / capacidades nativas do host; MCP, scripts, SVG, previews estáticos são rotas degradadas ou auxiliares, e devem ter evidências de degradação.
- Materiais externos só podem ser abstraídos em princípios de qualidade; não copiar nomes, estruturas de página, sistemas visuais, prompts, exemplos ou jargões comerciais de terceiros.
- Cada entrega deve ser fechada em loop: registrar evidências de execução, descobertas de revisão, decisão de
writeback/proposal/none-with-reason/blocked, e escrever o aprendizado reutilizável de volta no respectivo reference, template, validator, eval ou example.
Carregamento Progressivo
Leia apenas os arquivos necessários para o estágio atual:
| Estágio Atual | Ler | Quando Usar |
|---|---|---|
| Intenção e Pesquisa de Domínio | references/intent-domain-research.md, assets/domain-research-brief-template.md | Entrada do usuário vaga, domínio desconhecido, parece uma decisão estratégica, ou pode ser apenas um prompt único; primeiro escreva um resumo da pesquisa de domínio; marque como research-needed se faltarem evidências. |
| Superfície e Cadeia de Artefatos | references/experience-surface-model.md | A skill precisa produzir arquivos, mídia, screenshots, apresentações, relatórios, dashboards ou outros artefatos visíveis. |
| Design de Produto | references/product-design.md | Necessário decidir arquivos dentro do pacote, resultados visíveis em 3 minutos, jornada do usuário ou superfície de estreia. |
| Contrato de Execução | references/skill-contract.md | Usar antes de escrever ou modificar um pacote de skill candidato. |
| Limite de Abstração de Fonte | references/source-abstraction-boundary.md | Ao usar casos externos, exemplos internos ou materiais concorrentes, primeiro abstraia, depois reescreva. |
| Plano de Pacote | assets/package-plan-template.md | Mapear SKILL.md, arquivos de referência, assets, scripts, avaliações e exemplos antes de editar. |
| Rota Multimodal/Ferramentas | references/multimodal-tooling.md, assets/multimodal-prompt-brief-template.md | Skill depende de Image2, capacidades de mídia do host, MCP, renderizador local ou scripts; primeiro registre um inventário de capacidades locais e um resumo multimodal. |
| Decisões Interativas e Portão MVP | references/interactive-mvp-product-skill.md | Skill precisa exibir múltiplas decisões sob intenção vaga, travar estilo/capa/primeira tela/MVP antes da produção em lote, ou precisa reutilizar um fluxo de confirmação entre hosts Codex e Claude Code. |
| Design de Avaliação | references/evaluation-method.md, evals/trigger-eval.json | Projetar avaliação de gatilho, avaliação de saída, comparação de baseline, regressão ou verificação de aceitação. |
| Portão de Release | references/release-gate.md, assets/acceptance-run-template.md | Antes de afirmar que pode ser distribuído, migrado ou entregue a outros. |
| Governança de Loop Fechado | references/closed-loop-governance.md, assets/loop-run-record-template.md | Ao aceitar, falhar, revisar, desviar, preparar release ou quando o usuário solicitar "loop fechado"; deve-se preencher o registro de execução e a decisão de writeback. |
Os arquivos .md em assets/ são templates de trabalho para serem preenchidos por humanos; os .json são dados estruturados para scripts ou validação. Leia-os apenas ao criar o artefato correspondente. scripts/ só é executado durante validação, conversão ou empacotamento; não cole o conteúdo dos scripts no contexto da conversa.
Fluxo de Trabalho
- Classificar: Determinar se é
new-skill,refactor-skill,evaluate-skill,package-planounot-a-skill. - Buscar e Pesquisar: Coletar apenas evidências que mudarão a decisão do pacote, a superfície do artefato, a rota de ferramentas ou o critério de aceitação.
- Projetar: Determinar resultado, limites de gatilho, entrada/saída, rota de capacidades locais, face de decisão interativa, portão de travamento do MVP, estrutura do pacote e modos de falha públicos.
- Construir: Criar ou modificar apenas o conjunto mínimo de arquivos que o alvo atual precisa tocar.
- Validar: Executar validação do pacote, validação de loop fechado e validação de domínio; relatar o que a evidência estrutural, evidência de artefato, evidência de execução e confirmação humana provam, respectivamente.
- Fechar Loop: Preencher o registro de execução; decidir entre
writeback,proposal,none-with-reasonoublocked; apenas aprendizado reutilizável deve ser escrito de volta nas regras; não se pode passar um resumo da conversa como loop fechado.
Estrutura do Pacote
Arquivos padrão:
SKILL.md: Entrada leve, responsável pelo gatilho e contrato de execução.references/: Regras de domínio, modelo de produto, rota de capacidades, abstração de fonte, método de avaliação, portão de release.assets/: Templates preenchíveis, planilhas, dados estruturados ou resumos de prompt.scripts/: Validação determinística, conversão, renderização ou verificação de pacote.evals/: Avaliações de gatilho e casos de regressão.examples/: Exemplos de entrada/saída pequenos e reais; não incluir histórico privado, pontuações internas ou evidências de execução falsas.
Adicione novos arquivos apenas quando eles prevenirem uma falha específica ou tornarem a skill mais fácil de ser executada. Não adicione arquivos de referência apenas para salvar notas de pesquisa.
Parada Forçada
Pare imediatamente e explique o bloqueio se:
- A tarefa é apenas um prompt único, não um fluxo de trabalho repetível.
- A superfície do domínio é baseada em suposição, sem suporte de materiais do usuário, evidências locais ou fontes atuais.
- A skill multimodal não possui inventário de capacidades locais e rota de evidência de saída.
- A skill exige múltiplas decisões do usuário ou confirmação do MVP, mas não possui ferramenta de escolha nativa, interface de espera degradada, campo de status de confirmação e regra de parada para geração em lote.
- O pacote depende de arquivos gerados, mas não há como provar que arquivos, screenshots, mídia ou resultados renderizados existem.
- O escopo do gatilho se sobrepõe a outro pacote de skill ativo, sem um limite de roteamento.
- O design exporia histórico de avaliação privado, revisão interna, cicatrizes de implementação, ou faria parecer que imita um projeto externo.
Validação
Execute no diretório raiz do pacote:
python scripts/check_meta_skill_package.py .
python scripts/check_closed_loop.py .
Se o pacote gerado tiver seus próprios scripts, execute-os de acordo com os artefatos reais. Durante a validação, diferencie claramente entre verificação estrutural, evidência de artefato gerado, evidência de execução/ferramenta e aceitação manual; aprovação em um nível não substitui a aprovação em todos.
Relatório Final
Relate em português: quais arquivos foram alterados, decisão do pacote, limites de gatilho, mapa de carregamento progressivo, comandos de validação, níveis de evidência, decisão de loop fechado e riscos residuais. Forneça um pequeno antes/depois ou trecho de saída para que o usuário possa julgar se o pacote de skill está realmente mais fácil de usar.