gabriel-f-santos/gen-skill

O que gen-skill faz?

Uma skill que gera skills — gerador portátil de Skills para Agentes, orientado por entrevistas, para Claude Code, OpenAI Codex e opencode.

Visão Geral

gen-skill é uma skill especializada que atua como um gerador de skills orientado por entrevistas. Em vez de escrever manualmente arquivos SKILL.md ou configurações de skill, você simplesmente inicia uma conversa com seu agente, responde a algumas perguntas e a skill gera automaticamente uma skill portátil e pronta para uso.

Como Funciona

1. Inicie uma entrevista: Ative a skill e comece uma conversa descrevendo qual skill você deseja criar.
2. Responda perguntas direcionadas: O agente fará perguntas para entender:
   • Nome e descrição da skill
   • Funcionalidade principal e comportamento esperado
   • Instruções de sistema, prompts de usuário e scripts de ferramentas
   • Plataformas alvo (Claude Code, OpenAI Codex, opencode, etc.)
3. Geração da skill: Com base nas suas respostas, a skill gera um arquivo SKILL.md completo e validado.
4. Portabilidade: A skill gerada segue um formato padronizado, permitindo que seja usada em diferentes ecossistemas de agentes.

Plataformas Suportadas

• Claude Code (Anthropic)
• OpenAI Codex (OpenAI)
• Opencode (comunidade)

Pré-requisitos

• Um agente de IA compatível com o formato de skill (Claude Code, OpenAI Codex ou opencode)
• Permissão para ler/escrever arquivos no diretório de skills do agente

Instalação

1. Clone este repositório ou baixe o arquivo SKILL.md.
2. Coloque o arquivo SKILL.md no diretório de skills do seu agente:
   • Claude Code: ~/.claude/skills/
   • OpenAI Codex: diretório de skills configurado
   • Opencode: ~/.opencode/skills/
3. Reinicie seu agente ou recarregue as skills.

Uso

1. Ative a skill com um comando semelhante a:

   Use skill gen-skill para criar uma nova skill.
   

2. Siga o fluxo da entrevista guiada.
3. Ao final, a nova skill será gerada no diretório de skills.

Exemplo

Entrada do usuário:

Quero criar uma skill que me ajude a resumir artigos longos.

O agente pergunta:

Qual deve ser o nome da skill? Quais plataformas você deseja suportar? Que tipo de resumo você prefere (tópicos, parágrafos, etc.)?

Skill gerada: Um arquivo SKILL.md completo com instruções de sistema, prompts de usuário e configurações de ferramentas.

Estrutura de Skill Gerada

Uma skill gerada típica inclui:

• Nome e descrição: Metadados básicos
• Instruções de sistema: Comportamento e contexto para o agente
• Prompts de usuário: Modelos de entrada do usuário
• Scripts de ferramentas: Comandos e scripts executáveis
• Manipuladores de eventos: Gatilhos para ações específicas

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

Licença

Este projeto está licenciado sob a Licença MIT.