<!-- Notas entre agentes (informativas; ignoradas pelos agentes hospedeiros): - Raízes de habilidades compatíveis: GitHub Copilot CLI (~/.copilot/skills, ~/.agents/skills, .github/skills, .claude/skills, .agents/skills), Amp (.agents/skills, ~/.config/agents/skills, ~/.config/amp/skills), Claude Code (~/.claude/skills), Hermes Agent ($HERMES_HOME/skills, .hermes/skills, .agents/skills), OpenClaw (${OPENCLAW_STATE_DIR:-~/.openclaw}/skills, .agents/skills, skills/; ~/.agents/skills apenas com o estado padrão). OpenCode (~/.config/opencode/skills, ~/.claude/skills, .opencode/skills, ~/.agents/skills, .agents/skills). - `allowed-tools` é intencionalmente omitido para manter a neutralidade do agente: Copilot CLI usa nomes `shell`/MCP-server, Claude usa `Bash`/`Read`/`Write`/`Glob`/`Grep`, Amp adiciona `shell_command`. A habilidade precisa de shell (para executar extract.py) e leitura/escrita de arquivos — cada hospedeiro solicitará isso na primeira utilização. - Dica de argumento: <caminho-para-pasta-de-documentos-ou-glob>... [slug-do-nome-da-habilidade] -->

Conversor de Livros para Habilidades

Transforme conhecimento escrito em habilidades acionáveis para agentes, extraindo estrutura — não produzindo resumos.

Filosofia

Livros contêm expertise cristalizada: frameworks, princípios e técnicas que levaram anos para serem desenvolvidos. Esta habilidade extrai esse conhecimento em um formato que GitHub Copilot CLI, Amp, Claude Code, Hermes Agent, OpenCode, OpenClaw ou outro agente compatível pode usar repetidamente. Extraia estrutura, não resumos. Uma habilidade não é um relatório de livro. É um conjunto de ferramentas de:

• Frameworks nomeados (modelos mentais com aplicação clara)
• Princípios acionáveis (regras que guiam decisões)
• Técnicas (métodos passo a passo)
• Antí-padrões (o que evitar e por quê)
• Calibração de voz (como o autor pensa e se comunica)

Preserve a precisão do autor. Frameworks frequentemente têm nomes específicos por motivos. "Os 5 Porquês" não é intercambiável com "pergunte por quê várias vezes". Capture a formulação exata.

Camada de profundidade apropriada. Livros simples → habilidades simples. Livros complexos com 10+ frameworks → habilidades com arquivos de referência e capítulos sob demanda.

---

Modos de Operação

Quatro caminhos disponíveis. Roteie com base no que o usuário pede:

1. Conversão Completa (Padrão)

Gatilho: O usuário fornece um ou mais caminhos de documento/diretório/glob sem instruções especiais Ação: Execute todas as etapas abaixo (Etapas 0–9) Saída: Habilidade completa com SKILL.md, capítulos/, glossário, padrões, cheatsheet

2. Apenas Analisar

Gatilho: O usuário diz "analisar", "apenas extrair" ou "quero revisar antes de gerar" Ação: Execute as Etapas 0–3, em seguida, produza um relatório de extração estruturado (frameworks, princípios, técnicas encontrados). Pare — NÃO gere arquivos de habilidade. Saída: Relatório de análise para revisão do usuário

3. Gerar a partir de Análise Anterior

Gatilho: O usuário tem notas de análise existentes ou executou anteriormente a análise apenas Ação: Pule as Etapas 0–3, use a análise fornecida como entrada, execute as Etapas 4–9 Saída: Arquivos de habilidade a partir da análise fornecida

4. Atualizar / Incorporar (Habilidade Existente)

Gatilho: O usuário fornece um ou mais novos caminhos de origem e indica que deseja atualizar uma habilidade existente (seja apontando para a pasta da habilidade existente, fornecendo um slug de habilidade que já existe em SKILLS_HOME, ou solicitando explicitamente uma atualização). Ação: Execute a Etapa 0 (verificação fora do escopo), Etapa 1 (validar entradas), Etapa 1.5 (identificar tipo de livro) e Etapa 2 (extrair novos arquivos). Em seguida, pule para a Etapa 5 (identificar/detectar o caminho da habilidade existente) e execute o Fluxo de Trabalho de Atualização / Incorporação para mesclar o novo conteúdo nos arquivos de habilidade existentes. Saída: Habilidade existente atualizada com resumos de capítulos novos/revisados e índices/glossários mesclados.

---

Locais de Habilidade

Este conversor pode ser executado a partir de vários sistemas de habilidades. Ao procurar o script auxiliar deste conversor ou ao escrever a habilidade de livro gerada, prefira estes locais em ordem:

1. Habilidades pessoais do GitHub Copilot CLI: ~/.copilot/skills/
2. Habilidades pessoais entre agentes (Copilot, Amp, Codex; OpenClaw com seu estado padrão): ~/.agents/skills/
3. Habilidades pessoais do Claude Code: ~/.claude/skills/
4. Habilidades Copilot locais do projeto: .github/skills/
5. Habilidades Claude locais do projeto: .claude/skills/
6. Habilidades Amp / Copilot / OpenClaw locais do projeto: .agents/skills/
7. Habilidades globais do Amp: ~/.config/agents/skills/
8. Habilidades globais legadas do Amp: ~/.config/amp/skills/
9. Habilidades pessoais do Hermes Agent: $HERMES_HOME/skills/ (padrão para ~/.hermes/skills/)

…