Communitygithub.com

KimYx0207/meta-skill-creator

Uma Skill portátil para agentes de IA, projetada para projetar, refatorar e revisar skills reutilizáveis.

O que é meta-skill-creator?

Esta Skill permite que agentes de IA como Claude Code, Codex e Cursor criem, refinem e avaliem pacotes de skills reutilizáveis a partir de fluxos de trabalho reais do usuário. Ao contrário de prompts longos e monolíticos, ela organiza o conhecimento em uma estrutura modular com uma entrada leve (`SKILL.md`), detalhes carregados sob demanda via `references/`, `assets/`, `evals/` e `scripts/`. A Skill impõe um contrato rigoroso: antes de escrever qualquer arquivo, ela exige evidências de que o fluxo de trabalho merece ser transformado em skill, evitando a criação de skills para tarefas únicas. Ela suporta decisões interativas por meio de ferramentas nativas do host (como `AskUserQuestion` do Claude Code ou `request_user_input` do Codex), garantindo que o usuário seja consultado em vez de simular confirmações com cartões Markdown. A entrega é sempre fechada com um loop de governança: registros de execução, decisões de writeback/proposta/bloqueio e aprendizado reutilizável são documentados nos diretórios apropriados, garantindo rastreabilidade e melhoria contínua do pacote de skill.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add KimYx0207/meta-skill-creator

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.md deve 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_input do Codex / AskUserQuestion do 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 AtualLerQuando Usar
Intenção e Pesquisa de Domínioreferences/intent-domain-research.md, assets/domain-research-brief-template.mdEntrada 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 Artefatosreferences/experience-surface-model.mdA skill precisa produzir arquivos, mídia, screenshots, apresentações, relatórios, dashboards ou outros artefatos visíveis.
Design de Produtoreferences/product-design.mdNecessário decidir arquivos dentro do pacote, resultados visíveis em 3 minutos, jornada do usuário ou superfície de estreia.
Contrato de Execuçãoreferences/skill-contract.mdUsar antes de escrever ou modificar um pacote de skill candidato.
Limite de Abstração de Fontereferences/source-abstraction-boundary.mdAo usar casos externos, exemplos internos ou materiais concorrentes, primeiro abstraia, depois reescreva.
Plano de Pacoteassets/package-plan-template.mdMapear SKILL.md, arquivos de referência, assets, scripts, avaliações e exemplos antes de editar.
Rota Multimodal/Ferramentasreferences/multimodal-tooling.md, assets/multimodal-prompt-brief-template.mdSkill 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 MVPreferences/interactive-mvp-product-skill.mdSkill 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çãoreferences/evaluation-method.md, evals/trigger-eval.jsonProjetar avaliação de gatilho, avaliação de saída, comparação de baseline, regressão ou verificação de aceitação.
Portão de Releasereferences/release-gate.md, assets/acceptance-run-template.mdAntes de afirmar que pode ser distribuído, migrado ou entregue a outros.
Governança de Loop Fechadoreferences/closed-loop-governance.md, assets/loop-run-record-template.mdAo 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

  1. Classificar: Determinar se é new-skill, refactor-skill, evaluate-skill, package-plan ou not-a-skill.
  2. 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.
  3. 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.
  4. Construir: Criar ou modificar apenas o conjunto mínimo de arquivos que o alvo atual precisa tocar.
  5. 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.
  6. Fechar Loop: Preencher o registro de execução; decidir entre writeback, proposal, none-with-reason ou blocked; 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.

Habilidades Relacionadas