convez.ai
SkillAutomaçãoIntermediário
Questi0nM4rk

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 GitHub
InicialPluginScore · de 0 a 100

CLI 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/tagen

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
v3.1.0
Issues abertas
0
Contribuidores
2

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.

npm version CI License: MIT

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

CommandExampleDescription
listtagen listList every card as <type>/<name>
listtagen list --type lang --aliasesFilter to one type, show aliases
validatetagen validateWalk the tree, report every rule violation; exit non-zero on any
gettagen get strict csharp --jsonResolve a composition into a JSON manifest
gettagen get methodologyBare type-name positional triggers browse intent
gettagen get strict csharp python --pin lang=python --jsonOverride alphabetical-first slot fill
addtagen addInteractive 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:

  1. Fuzzy-matches positional args to <type>/<name> (3-char min; exact > prefix > substring > Levenshtein).
  2. Resolves requires: [<type>] slots by picking a matched card under that type — alphabetical first, --pin <type>=<name> overrides.
  3. Collects subagents declared by review/methodology cards, plus their validators/*.ts.
  4. 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
Ver o original no GitHub

Bom para

Relacionados