Skills
As skills de agente que o Blume oferece — playbooks que ensinam um agente de programação como Claude Code, Codex ou Cursor a construir e manter um site de documentação Blume.
O Blume oferece agent skills — playbooks que ensinam um agente de programação (Claude Code, Codex, Cursor) a executar uma tarefa no formato Blume sem que você precise explicá-la. Elas ficam no GitHub, na pasta skills/ do repositório, e vêm incluídas no pacote instalado em skills/, de modo que qualquer agente pode ser apontado diretamente para um SKILL.md.
Blume
A skill principal. Ela ensina ao agente o que é o Blume e como estruturar, escrever e configurar um site — navegação derivada do sistema de arquivos, o schema de configuração, componentes de conteúdo — e o direciona para a documentação completa incluída no pacote instalado (o diretório docs/ dentro de blume, resolvido a partir de onde quer que seu gerenciador de pacotes o instale — em um monorepo pnpm, isso é o node_modules do workspace dependente, não a raiz do repositório). Instale-a em qualquer projeto em que um agente ajude você a construir sua documentação:
npx skills add haydenbleasel/blumeMigração
A blume-migrate migra um site de documentação existente para o Blume a partir do Mintlify, Docusaurus, GitBook, MkDocs, ReadMe, das outras fontes citadas ou de qualquer outro framework. Ela busca um Blume idiomático em vez de uma conversão linha por linha, com uma referência de mapeamento para cada framework citado, um redirecionamento para cada URL que muda de lugar e um relatório de tudo o que ela descarta. A forma mais rápida de executá-la é o blume migrate, que detecta seu framework e abre o Codex ou o Claude Code com a cópia incluída no pacote. Para usá-la a partir de outro agente, instale-a:
npx skills add haydenbleasel/blume --skill blume-migrateDocumentação que se atualiza sozinha
A blume-update-docs mantém sua documentação em sincronia com o produto que ela documenta. A cada execução — normalmente a partir de um agendamento que você configura no seu executor de agentes — ela audita PRs mesclados recentemente, changelogs, schemas de configuração e a ajuda da CLI em relação ao conteúdo da documentação, atualiza apenas as páginas que estão factualmente desatualizadas (trabalhos por trás de feature flags são ignorados), verifica com blume build e blume validate e abre ou atualiza um pull request blume/*. Se nada divergiu, ela reporta uma execução limpa sem alterações em vez de abrir um PR ruidoso.
npx skills add haydenbleasel/blume --skill blume-update-docsO Blume não hospeda a automação — conecte a skill a uma tarefa agendada no Claude Code, a uma automação do Codex ou do Cursor, ou a um cron simples, com permissão para ler o histórico do repositório e abrir PRs. Um prompt semanal típico:
Use the blume-update-docs skill. Review the PRs merged within the last 7 days and compare them to the docs content. Ignore work behind feature flags. If docs need updates, make them, verify the docs build, and open a blume/* PR. If not, report what you checked and do not open a PR.Escrevendo a skill do seu site
A blume-write-skill escreve a skill de agente da sua própria documentação: um único SKILL.md, baseado na documentação, que ensina um agente de programação a usar seu produto — configuração, conceitos principais, tarefas comuns e armadilhas — com cada tópico vinculado à sua página. Ela substitui o mapa de páginas que o Blume gera em /skill.md. A forma mais rápida de executá-la é o blume skill, que descobre onde a skill deve ficar e abre o Codex ou o Claude Code com a cópia incluída no pacote:
blume skill --claude # or --codexPara usá-la a partir de outro agente, instale-a:
npx skills add haydenbleasel/blume --skill blume-write-skill