tagen

Skill-graph CLI for qsm-marketplace: resolve tag queries, assemble plugins, validate vocabulary.

Install

bun add -g @questi0nm4rk/tagen
# or
npm install -g @questi0nm4rk/tagen

Commands

| Command | Example | Description | |---------|---------|-------------| | list | tagen list | List all catalog cards | | list | tagen list --filter language=python | Filter by tag | | tags | tagen tags | Print controlled vocabulary | | resolve | tagen resolve --phase implementation --language typescript | Match skills by tag query | | validate | tagen validate | Check all card tags against vocabulary.yaml | | sync | tagen sync | Find skill files not registered in build.yaml | | add | tagen add | Scaffold a new catalog card | | build | tagen build --plugin qsm-python-lang | Assemble a plugin from tag queries | | build | tagen build --all | Assemble all plugins | | diff | tagen diff --all | Check if plugin output is in sync with catalog |

Usage as devDependency

In a marketplace repo:

{
  "devDependencies": {
    "tagen": "latest"
  }
}

bun install
bunx tagen validate
bunx tagen build --all
bunx tagen diff --all     # CI gate: exits non-zero if output is stale

How It Works

Tagen walks up from cwd to find skill-graph/vocabulary.yaml. No config file needed. Catalog cards live in skill-graph/skills/*.md. Plugins are assembled from plugins/<name>/build.yaml tag queries.

See docs/specs/ for architecture decisions.

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