LiliaLUO/agent-skill-apprentice

O que agent-skill-apprentice faz?

Fluxo de trabalho para avaliar repositórios do GitHub e gerar habilidades de agente reutilizáveis a partir de projetos de alto sinal.

Propósito

Este fluxo de trabalho automatiza a curadoria e transformação de repositórios de software em habilidades modulares para agentes de IA. Ao analisar projetos promissores, extraímos conhecimento encapsulado em comandos, APIs e padrões de código para criar skills que podem ser invocadas por agentes em diferentes contextos.

Como Funciona

1. O agente recebe um repositório alvo (ex: github.com/usuario/projeto).
2. O fluxo avalia o repositório com base em critérios como: frequência de commits, qualidade da documentação, presença de testes e utilidade funcional.
3. Se aprovado, o agente analisa a estrutura do projeto e extrai:
   • Comandos de linha de comando
   • APIs expostas
   • Configurações relevantes (variáveis de ambiente, arquivos de configuração)
   • Fluxos de trabalho (workflows) internos
4. Com esses dados, é gerada uma nova skill para o agente, completa com um SKILL.md descritivo e metadados.

Uso

Para usar este workflow, o agente deve ser instruído a iniciar o processo de avaliação com o comando:

agent-skill-apprentice --evaluate <url-do-repositorio>

Onde <url-do-repositorio> é a URL completa do repositório GitHub a ser avaliado.

Opções

• --evaluate <url>: Inicia a avaliação de um repositório.
• --scaffold <url>: Gera a estrutura da skill a partir de um repositório já avaliado.
• --list: Lista as skills geradas e seus status.

Exemplo de Saída

Após a avaliação, o agente criará uma pasta com o nome da skill (derivado do repositório) contendo:

skills/
  nome-da-skill/
    SKILL.md
    prompts/
      prompt-principal.md
      prompt-tarefa-exemplo.md
    config.json

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Outros agentes baseados em LLM com suporte a skills

Licença

MIT