Repolode
Enviar
virgiliojr94

virgiliojr94/book-to-skill

Um conversor que transforma livros técnicos e coleções de documentos em skills estruturadas que assistentes de programação com IA podem carregar sob demanda.

Ver no GitHub
Estrelas
35,351
Forks
3,728
Issues abertas
24
Último commit
anteontem

O que é?

book-to-skill recebe um PDF, EPUB, DOCX, Markdown, HTML ou outro documento — ou uma pasta inteira de fontes — e transforma esse conteúdo em um pacote Agent Skills. A saída inclui um SKILL.md com os modelos mentais essenciais e um índice de capítulos, arquivos por capítulo carregados sob demanda e também arquivos de glossário, padrões e resumo prático. O objetivo é dar ao agente a estrutura de um livro, em vez de apenas um resumo, para que ele possa responder a perguntas com base no conteúdo real dos capítulos.

A ferramenta funciona como um comando slash no estilo do Claude Code. Um extrator determinístico em Python converte a fonte em texto limpo e metadados; em seguida, um agente segue a especificação do gerador para criar a skill. As skills instaladas ficam no diretório de skills compartilhado entre agentes e podem ser lidas por hosts como GitHub Copilot CLI, Amp, Codex, OpenCode e OpenClaw. O Claude Code e o Hermes Agent usam seus próprios diretórios.

A mesma abordagem serve para documentação interna, diretrizes de marca, coleções de artigos de pesquisa e especificações consultadas com frequência. A ideia é processar localmente materiais protegidos por direitos autorais a partir de cópias que o usuário possui e mantê-los privados.

Recursos principais

  • 01Converte fontes em PDF, EPUB, DOCX, HTML, RTF, MOBI e Markdown em um pacote Agent Skills.
  • 02Gera um índice SKILL.md e arquivos por capítulo, carregados apenas quando alguém pergunta sobre um tópico.
  • 03Cria arquivos de glossário, padrões e resumo prático junto com os capítulos.
  • 04Inclui um extrator determinístico com um comando --check que informa quais ferramentas estão instaladas.
  • 05Funciona com vários hosts de agentes compatíveis com o padrão Agent Skills.

Casos de uso

  • Consultar um livro técnico de dentro do Claude Code ou do Copilot CLI enquanto programa.
  • Transformar uma pasta de registros de decisões de arquitetura ou runbooks em uma skill para a equipe.
  • Deixar uma coleção de artigos de pesquisa e anotações pessoais pesquisável por um agente.
  • Estudar um livro denso pedindo ao agente capítulos ou conceitos específicos.

Início rápido

  1. 1

    Instale a skill com a CLI cross-agent skills

    npx skills add virgiliojr94/book-to-skill
  2. 2

    Verifique quais extratores estão instalados e obtenha os comandos para instalar os que faltam

    python3 scripts/extract.py --check
  3. 3

    Converta uma pasta de livros ou documentos em uma skill usando seu assistente de programação com IA

    /book-to-skill <path|folder|glob> [skill-name]

Antes de usar

  • É necessário um assistente de programação com IA compatível com o padrão Agent Skills, como Claude Code ou Codex.
  • PDFs digitalizados sem camada de texto precisam passar por OCR primeiro; caso contrário, o extrator será interrompido.
  • A extração de PDF, EPUB, DOCX e MOBI depende de ferramentas opcionais que talvez você precise instalar separadamente.

Tópicos

#agent-skills#ai-agents#pdf-to-markdown#knowledge-base#rag#self-study#book-to-skill#context-engineering#document-processing#edtech

Perguntas frequentes

O que é book-to-skill?
Um conversor que transforma livros técnicos e coleções de documentos em skills estruturadas que assistentes de programação com IA podem carregar sob demanda. book-to-skill recebe um PDF, EPUB, DOCX, Markdown, HTML ou outro documento — ou uma pasta inteira de fontes — e transforma esse conteúdo em um pacote Agent Skills. A saída inclui um SKILL.md com os modelos mentais essenciais e um índice de capítulos, arquivos por capítulo carregados sob demanda e também arquivos de glossário, padrões e resumo prático. O objetivo é dar ao agente a estrutura de um livro, em vez de apenas um resumo, para que ele possa responder a perguntas com base no conteúdo real dos capítulos.
book-to-skill é gratuito? Qual é a licença?
book-to-skill é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
book-to-skill ainda é mantido?
Manutenção ativa. O último commit de book-to-skill foi em 18 de out. de 2026.
Para que posso usar book-to-skill?
Consultar um livro técnico de dentro do Claude Code ou do Copilot CLI enquanto programa. Transformar uma pasta de registros de decisões de arquitetura ou runbooks em uma skill para a equipe. Deixar uma coleção de artigos de pesquisa e anotações pessoais pesquisável por um agente. Estudar um livro denso pedindo ao agente capítulos ou conceitos específicos.
Como instalar book-to-skill?
Instale a skill com a CLI cross-agent skills: npx skills add virgiliojr94/book-to-skill Verifique quais extratores estão instalados e obtenha os comandos para instalar os que faltam: python3 scripts/extract.py --check Converta uma pasta de livros ou documentos em uma skill usando seu assistente de programação com IA: /book-to-skill <path|folder|glob> [skill-name]
Onde consigo book-to-skill?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/virgiliojr94/book-to-skill

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados