Tagen — CLI para Composição de Skill Graphs
Questi0nM4rk/tagen
Assembla manifestos de composição de skills a partir de um catálogo de cards tipados
Ver no GitHubCLI em TypeScript que lê uma estrutura de diretórios de cards tipados (`brain/<type>/<name>/`) e emite um manifesto JSON com todas as dependências e configurações que um agente Claude deve carregar para uma tarefa. Usa o próprio sistema de diretórios como vocabulário, eliminando a necessidade de arquivos de configuração separados.
Instalação
npx convez-ai Questi0nM4rk/tagen1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Organizar e compor plugins Claude Code em projetos complexos
- Validar integridade de estruturas de skills antes do deploy
- Resolver dependências automáticas entre skills usando fuzzy matching
- Gerar manifestos JSON estruturados para carregamento dinâmico de agentes
Veredito

Ferramenta sólida e bem-construída para times que trabalham com catálogos de skills reutilizáveis. Adota uma abordagem minimalista (o diretório é o schema) que reduz overhead de configuração, com validação rigorosa e bom suporte a extensibilidade via validators.
README
A tradução para o português deste README ainda está na fila.
tagen
Read-only CLI that walks a brain/<type>/<name>/ directory tree of typed cards
and emits a JSON composition manifest naming everything an agent should load
for a task.
The directory tree IS the vocabulary — no vocabulary.yaml, no
capabilities.yaml, no tags: / provides: / emits: / consumes:.
Five frontmatter fields total: description, aliases, requires,
subagents, model.
Install
bun add -g @questi0nm4rk/tagen
# or
npm install -g @questi0nm4rk/tagen
Commands
| Command | Example | Description |
|---|---|---|
list | tagen list | List every card as <type>/<name> |
list | tagen list --type lang --aliases | Filter to one type, show aliases |
validate | tagen validate | Walk the tree, report every rule violation; exit non-zero on any |
get | tagen get strict csharp --json | Resolve a composition into a JSON manifest |
get | tagen get methodology | Bare type-name positional triggers browse intent |
get | tagen get strict csharp python --pin lang=python --json | Override alphabetical-first slot fill |
add | tagen add | Interactive scaffold for a new card (only writer) |
All commands are read-only except add.
Usage as devDependency
In a marketplace repo:
{
"devDependencies": {
"@questi0nm4rk/tagen": "latest"
}
}
bun install
bunx tagen validate
bunx tagen get strict csharp --json | jq .
How It Works
Tagen walks up from cwd to find a brain/ directory containing at least one
<type>/<name>/CORE.md. No config file. Each card carries optional
references/ (pull-on-demand long-form), and review/methodology cards may
ship validators/ (executable scripts) plus a lib/ for shared modules.
tagen get:
- Fuzzy-matches positional args to
<type>/<name>(3-char min; exact > prefix > substring > Levenshtein). - Resolves
requires: [<type>]slots by picking a matched card under that type — alphabetical first,--pin <type>=<name>overrides. - Collects subagents declared by review/methodology cards, plus their
validators/*.ts. - Emits a JSON manifest with all paths root-relative, so the agent resolves them as
root + "/" + path.
See docs/specs/SPEC-tagen.md for the full spec and docs/tagen-get-manifest.schema.json for the manifest contract.
Contributing
Fork → branch → PR. ai-guardrails enforces conventional commits and blocks direct commits to main.
bun test # must be green
bun run typecheck # must be clean
bun run lint # must be clean