Skills

As nove skills existem porque as partes mecânicas (criar a estrutura, frontmatter, regeneração de índices, validação) são tediosas, e fazê-las por você deixa o tempo para a parte que só você pode fazer: decidir o que a coisa é.

As skills são opcionais. O Framework não é.

Você pode escrever cada arquivo à mão; nada no padrão depende de tooling. Mas mantenha _eidos/ em disco de qualquer forma. O Framework (a estrutura) é o que te mantém fiel ao padrão: sem ele, a forma com que você escreve mora na sua cabeça, se desvia um pouco a cada Blueprint e deixa de ser um padrão no momento em que outra pessoa escreve um.

Uma skill é uma pasta com um SKILL.md dentro, então qualquer agente que leia esse formato pode executá-las. O padrão sobre o qual elas operam é neutro em relação ao agente por design.

O caminho de autoria

Três skills se sobrepõem, e escolher a errada é a fonte habitual de uma sessão ruim:

Você tem	Use	Ela produz
Uma ideia, meio formada	iterate	Um entendimento. Nenhum arquivo.
Algo que você já decidiu	eidos	O Blueprint
Um rascunho já escrito	format	As mesmas palavras, com forma

Todas as nove

iterateQuestiona uma ideia bruta até ela ficar parada. Não escreve nada.

eidosEscreve e valida Blueprints. A skill principal.

formatRemodela um rascunho bruto, preservando as suas palavras.

installLevanta uma raiz onde não há uma.

configureAcrescenta uma coleção, flavor ou propriedade; preenche retroativamente.

indexReconstrói a listagem gerada de cada coleção.

canvasDesenha os Blueprints como um canvas do Obsidian.

whoamiDefine quem está no assento: papel e calibração.

migrateMigra para outra versão do padrão.

Instalação

Claude Desktop / Web

Customize → Plugins → + → Add marketplace from repository, e informe o repositório:

https://github.com/BuildableWorks/Eidos

Depois instale eidos a partir desse marketplace. Qualquer plano pago.

O Desktop executa cada skill restrita à própria pasta, e toda skill é autocontida, então isso se comporta exatamente como no Claude Code.

Se você prefere subir um arquivo a acrescentar um repositório, ou está compartilhando um Framework privado, construa o zip a partir de um clone e escolha upload a custom plugin file:

./scripts/package-plugin.sh   # → dist/eidos-plugin.zip

Claude Code

O repositório é um marketplace público de plugins:

/plugin marketplace add BuildableWorks/Eidos
/plugin install eidos@eidos

Para desenvolvimento contra um clone local:

claude --plugin-dir /path/to/eidos     # ephemeral, one session

Ou coloque uma pasta direto, sem plugin envolvido: <repo>/.claude/skills/<name>/ para um projeto, ~/.claude/skills/<name>/ para todo lugar. Uma cópia de projeto vence uma global.

Codex

O Codex procura skills em .agents/skills/, da mais próxima primeiro: a raiz do repositório, depois ~/.agents/skills/ para todos os repositórios. Copie as pastas para lá:

git clone https://github.com/BuildableWorks/Eidos.git
mkdir -p .agents/skills && cp -r Eidos/skills/* .agents/skills/

Nada a configurar. O Codex reconhece qualquer pasta cujo SKILL.md carregue name e description, o que toda skill do Eidos faz. Para desligar uma sem apagá-la, acrescente-a a ~/.codex/config.toml:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Qualquer outro agente

Não há empacotamento para isso, mas também não há nada a empacotar: cada skill é uma pasta autocontida com um SKILL.md, e o formato é um padrão aberto.

Copie as pastas para onde o seu agente lê instruções, e aponte para elas do jeito que ele espera. As três que precisam de parte do padrão carregam uma cópia versionada, então nada quebra quando são movidas.

Por que três skills carregam uma cópia do padrão

Você vai notar que EIDOS.md, seeds/ e versions/ aparecem duas vezes no repositório: uma na raiz, outra dentro de algumas pastas de skill. Isso é deliberado.

As cópias de nível superior são a fonte de verdade e a superfície pública de revisão. Mas uma skill muitas vezes não consegue alcançá-las depois de instalada:

• O Claude Desktop isola cada skill na própria pasta: sem arquivos irmãos.
• Uma instalação por marketplace git envia só o que está versionado: nada que esteja no gitignore chega.

Então as três que precisam de parte do padrão a carregam, versionada: eidos (o conjunto de regras), install (as sementes) e migrate (o histórico de versões). As outras seis leem o Framework da sua raiz em tempo de execução e não precisam de nada.

scripts/sync-skills.sh regenera essas cópias a partir das fontes de nível superior, e --check falha se alguma tiver se desviado.

Nota

A troca foi escolhida de propósito. Colocar as cópias no gitignore quebra as instalações do Desktop; remover as cópias de nível superior custaria a única casa revisável do padrão. Então as duas existem, e um script as mantém juntas.

Acrescentar a sua

Crie skills/<sua-skill>/SKILL.md e ela é distribuída com o plugin automaticamente.

Para compartilhar um Framework com um colega, entregue o zip autocontido que o script de empacotamento constrói, ou envie para um repositório git privado e compartilhe a URL.