dragoon-skills

Generate optimal Claude Code configuration for any project. Creates CLAUDE.md, settings.json, skills, hooks, agents, and commands tailored to your stack. Run /forge to start.

File-level accessibility audit with concrete line locations for every finding. Eight rules: img-missing-alt, button-without-label, link-without-text, input-without-label, positive-tabindex, click-handler-on-non-interactive, autofocus, low-contrast-token-pair. Use when the user wants to audit a11y, find accessibility regressions, or gate a PR on a11y. Run as `node ~/.claude/skills/dragoon/skills/accessibility/scripts/accessibility.js [path]`.

Run /brief, /plan-eng, and /plan-design in one shot to bootstrap a complete sprint plan. All three documents land in .dragoon/plans/ pre-filled with codebase facts. Use when the user wants to spin up a full plan quickly. Defaults to dry-run; pass --apply to write all three files. Run as `node ~/.claude/skills/dragoon/skills/autoplan/scripts/autoplan.js "<idea>"`.

Snapshot codebase metrics (file count, total lines, /critique scores) for trend tracking. Subcommands capture/list/compare/show. Snapshots stored as JSON in .dragoon/benchmarks/. Use to track design quality and codebase growth over time. Run as `node ~/.claude/skills/dragoon/skills/benchmark/scripts/benchmark.js <subcommand>`.

Generate a structured product brief markdown from a one-line idea, pre-filled with codebase facts (stack, type system, palette, components count) from dragoon.json. Use when the user is starting a new feature, project, or initiative and wants to think through it before coding. Output goes to .dragoon/plans/brief-{slug}-{date}.md. Defaults to dry-run preview; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/brief/scripts/brief.js "<idea>"`.

Generate a curl-based canary watcher script for a deployed URL. Validates URL is http/https, status code is 100-599, interval is 5-86400 seconds. The generated script supports one-shot (default) and --watch (continuous loop) modes. Wire into cron or a CI scheduled job. Run as `node ~/.claude/skills/dragoon/skills/canary/scripts/canary.js <url>`.

Write a checklist of destructive commands the user wants to think twice about (rm -rf, force push, hard reset, db drop, etc.) to .dragoon/CAREFUL.md. dragoon does NOT block commands at runtime - this is a discipline tool, a list the agent reads before risky operations. Use to set explicit guardrails for an AI agent or new contributor. Run as `node ~/.claude/skills/dragoon/skills/careful/scripts/careful.js`.

Generate a color palette token file (CSS variables, tailwind config, or JS module) from the palette detected by /scan. Uses inferred role names (foreground, background, accent, danger, etc.) where possible, numeric fallback otherwise. Use when the user wants to formalize color tokens, extract a palette from existing code, or scaffold a color system. Defaults to dry-run preview; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/color/scripts/color.js`.

Generate a UI component scaffold in the codebase's actual style. Reads dragoon.json to match framework (react/vue/svelte), styling layer (tailwind/css-modules/plain), language (typescript/javascript), and design tokens (radius, spacing, palette). Defaults to dry-run preview; pass --apply to write files. Use when the user wants to create a new component, scaffold UI primitives, or add a component to their codebase. Run as `node ~/.claude/skills/dragoon/skills/component/scripts/component.js <Name>`.

Score a codebase's design quality 0-100 across six categories (typography, color, spacing, motion, accessibility, consistency) plus an overall weighted score. Every score is derived from concrete metrics in dragoon.json with transparent math, no LLM, no vibes. Use when the user asks "what's the design quality of this codebase", "rate my design", "audit the design system", or wants a CI gate for design. Includes a per-category breakdown explaining each deduction. Auto-scans if no manifest exists. Run as `node ~/.claude/skills/dragoon/skills/critique/scripts/critique.js [root]`.

Scaffold a playwright visual regression test suite that takes per-route full-page screenshots and compares against committed baselines. Pixel diffing is done by playwright's toHaveScreenshot, not by dragoon. Use when the user wants visual regression coverage. Pass --routes to set the routes to capture. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/diff/scripts/diff.js`.

Detect drift between markdown docs (README, docs/) and the actual codebase. Catches references to npm scripts that don't exist, scoped dependencies not in package.json, file paths in backticks that don't resolve on disk, and undocumented npm scripts. Use to audit documentation hygiene before a release or after a major refactor. Exits non-zero on findings. Run as `node ~/.claude/skills/dragoon/skills/docs/scripts/docs.js`.

Generate a new dragoon skill scaffold (SKILL.md, scripts/<name>.js, test/<name>.test.js, README.md) into .dragoon/forge/<name>/ for review. dragoon does NOT auto-install forged skills. After review, copy into ~/.dragoon/skills/ and add an entry to bin/dragoon's COMMANDS map. Use to extend the pack with custom skills. Run as `node ~/.claude/skills/dragoon/skills/forge/scripts/forge.js <name>`.

Declare directories that are off-limits to edits. Stores the list in .dragoon/freeze.json. Optionally installs a git pre-commit hook that fails the commit if any frozen path is touched. Subcommands list/add/remove/hook/check. Use when isolating a refactor, locking legacy directories, or onboarding a contributor with limited scope. Run as `node ~/.claude/skills/dragoon/skills/freeze/scripts/freeze.js <subcommand>`.

Generate a markdown dev handoff doc with everything the next engineer needs - stack, design tokens, palette, type scale, spacing grid, motion, existing components, and conventions - all pulled from dragoon.json. Use when handing off work to another engineer or documenting the codebase for new contributors. Output goes to .dragoon/handoff/handoff-{slug}.md. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/handoff/scripts/handoff.js [feature]`.

One-line install for dragoon. Detects supported coding agents (claude-code, codex, cursor, opencode, factory, kiro) and installs the skill pack into each. Multi-host on day one. Use when the user wants to install dragoon, mentions setup, or asks how to add dragoon to their environment. The install script is `./setup` at the repo root.

Catalog of components (PascalCase files), hooks (useFoo), pages/routes, story files, and token files in the codebase. Use to understand what already exists before adding more, or to audit a design system. Heuristic-based, no AST. Run as `node ~/.claude/skills/dragoon/skills/inventory/scripts/inventory.js [root]`.

Structured root-cause investigation template. Encodes the rule "no patches until you can reproduce, predict, and explain the bug." Forces hypothesis-test pairs, evidence collection, and a prevention plan. Use when the user reports a bug or asks to fix something they don't fully understand yet. Run as `node ~/.claude/skills/dragoon/skills/investigate/scripts/investigate.js "<symptom>"`.

Post-merge sanity check. Verifies branch, HEAD sha, that local matches remote, and that the working tree is clean. dragoon does NOT trigger deploys (platform-specific creds out of scope). Use right before a deploy step in CI or before manual prod pushes. Exits non-zero if any check fails. Run as `node ~/.claude/skills/dragoon/skills/land/scripts/land.js`.

Architecture overview of the codebase. Reports total file/line/byte counts, top hot files (most imported), largest files by line count, orphan files (imported by nobody), and most-used external dependencies. Pure regex on import statements, no AST. Use to understand a new codebase, find dead code, or audit dependency surface. Run as `node ~/.claude/skills/dragoon/skills/map/scripts/map.js [root]`.

Small persistent key-value store at .dragoon/memory.json for project-specific facts dragoon (and the user) want to remember across sessions. Subcommands list/get/set/remove/clear. Keys are lowercase ascii (./_/-, max 64). Values are plain text (max 8KB, max 256 keys). Use to remember conventions, decisions, gotchas. Run as `node ~/.claude/skills/dragoon/skills/memory/scripts/memory.js <subcommand>`.

Generate motion tokens (durations + easings) using values detected by /scan, falling back to material-quality defaults when nothing was detected. Produces fast/normal/slow durations and standard/enter/exit easings. Use when the user wants to formalize motion tokens or scaffold a motion system. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/motion/scripts/motion.js`.

Static performance hints (large images, missing img dimensions, no loading=lazy, sync script tags) plus optional Lighthouse JSON report ingestion that surfaces failing audits ranked by potential ms savings. Use when the user wants to audit web performance or process a Lighthouse report. Dragoon does NOT run Lighthouse itself - generate the report with `npx lighthouse <url> --output json --output-path lh.json` and pass --lighthouse. Run as `node ~/.claude/skills/dragoon/skills/perf/scripts/perf.js [--lighthouse path]`.

Generate a structured design plan markdown that respects the constraints in dragoon.json (spacing grid, type ratio, palette, font families). Forces a screens-and-flows breakdown, accessibility plan, responsive plan, and design review checklist gated on /critique and /slop. Use after /brief or before any UI work. Output goes to .dragoon/plans/plan-design-{slug}-{date}.md. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/plan-design/scripts/plan-design.js "<idea>"`.

Generate a structured engineering plan markdown for an idea, pre-filled with codebase facts (stack, dependencies, current critique score) from dragoon.json. Forces a test matrix, edge cases, migration plan, and review checklist. Use after /brief or before any non-trivial feature implementation. Output goes to .dragoon/plans/plan-eng-{slug}-{date}.md. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/plan-eng/scripts/plan-eng.js "<idea>"`.

Scaffold a playwright e2e test suite with 4 smoke tests (page loads, h1 visible, no console errors, no broken images). Detects the project's stack to set the right baseURL. Writes a runner script that installs browsers on first run. Dragoon does NOT install browsers itself - the runner script does. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/qa/scripts/qa.js`.

Generate a structured research template for a topic. Use before deciding to build something - forces specific decision-driven research with sources, expert disagreement, and a steelman. dragoon does NOT fetch the web. Output goes to .dragoon/research/research-{slug}-{date}.md. Run as `node ~/.claude/skills/dragoon/skills/research/scripts/research.js "<topic>"`.

Weekly retro markdown template with git stats pre-loaded (commit count, files changed, +/- lines, contributors). Forces a what-shipped, what-slipped, what-we-learned, what-to-do-less-of, what-to-do-more-of, and quality-trends section. Use end-of-week or end-of-sprint. Output goes to .dragoon/retros/retro-{date}.md. Run as `node ~/.claude/skills/dragoon/skills/retro/scripts/retro.js`.

Unified code + design review in a single pass. Runs slop detection, design critique, and engineering signals (TODO/FIXME, any types, large files) at once. On any UI files in scope (jsx/tsx/vue/svelte/css/scss/html), /critique and /slop run automatically - engineering review and design review in one read. Use when the user wants to review a PR, diff, file, or folder. Supports `--diff` to review only files changed in git working tree. Run as `node ~/.claude/skills/dragoon/skills/review/scripts/review.js [path]`.

Fingerprint a codebase's design DNA and write dragoon.json. Use when the user wants to set up dragoon in a project, or asks to "scan", "fingerprint", or "analyze" the design system. Always run this first before /critique, /slop, or /review on a project that hasn't been scanned yet. Outputs detected stack, palette, type scale, spacing grid, motion curves, and accessibility metrics. Run as `node ~/.claude/skills/dragoon/skills/scan/scripts/scan.js [root]`.

Build a structured packet to paste into another model or share with a colleague. Includes branch, head, recent commits, and optional file contents (max 5 files, 200 lines each). dragoon does NOT call other models for you - this is the prompt you copy. Use when stuck on an approach, considering tradeoffs, or wanting external review. Run as `node ~/.claude/skills/dragoon/skills/second-opinion/scripts/second-opinion.js "<topic>" [--file path]`.

Pre-PR check orchestrator. Runs /critique with a threshold (default 80), /slop --severity high, gathers git context (branch, changed files), and optionally opens a PR via the gh CLI. Use before opening any PR. Exits non-zero if any check fails. Run as `node ~/.claude/skills/dragoon/skills/ship/scripts/ship.js`.

Detect AI-generated design slop with concrete, locatable findings. Use when the user wants to check code for AI authorship tells, design inconsistency, or generic UI patterns. Each finding includes file, line, column, the offending snippet, why it's a problem, and a concrete fix. 12 rules covering shadow/radius variant explosion, AI-default gradients, lorem ipsum, inline styles, off-grid spacing (when a manifest exists), off-palette colors (when a manifest exists), tailwind class bloat, missing alt text, console.log leftover, emoji in headings, and transition-all defaults. Run as `node ~/.claude/skills/dragoon/skills/slop/scripts/slop.js [path]`.

Generate a spacing scale token file based on the spacing grid detected by /scan (4px, 8px, etc). Produces an 8-step t-shirt scale (xs/sm/md/lg/xl/2xl/3xl/4xl) anchored on the grid. Use when the user wants to formalize spacing tokens or scaffold a layout system. Defaults to dry-run; pass --apply to write. Run as `node ~/.claude/skills/dragoon/skills/spacing/scripts/spacing.js`.

Scaffold storybook config (.storybook/main.ts, preview.ts) plus auto-generated *.stories.tsx files for every PascalCase component in the codebase that has a matching named export. Caps at 50 components per run. dragoon does NOT install storybook - run `npx storybook init` after. Use to bootstrap stories quickly across an existing component library. Run as `node ~/.claude/skills/dragoon/skills/storybook/scripts/storybook.js`.

Export design tokens to figma.tokens.json (tokens-studio-compatible format) so they can be imported into the Figma "tokens studio" plugin. dragoon does NOT live-sync with Figma - that requires OAuth and the Figma REST API. Use for one-way export from code to Figma, manually re-run after major token changes. Run as `node ~/.claude/skills/dragoon/skills/sync/scripts/sync.js`.

Generate one consolidated tailwind.config.js combining colors, spacing, fontFamily, fontSize, borderRadius, transitionDuration, and transitionTimingFunction from the manifest. Single file instead of four separate token cjs files. Use when setting up tailwind for the first time or refreshing the config after major token changes. Run as `node ~/.claude/skills/dragoon/skills/tailwind/scripts/tailwind.js`.

Generate a type scale token file (CSS variables, tailwind config, or JS module) anchored on the type ratio detected by /scan. Use when the user wants to formalize their typography system, extract a scale from existing code, or scaffold typography tokens. Defaults to dry-run preview; pass --apply to write. Auto-picks format based on stack: tailwind for tailwind projects, JS module for JS-heavy stacks, CSS variables otherwise. Run as `node ~/.claude/skills/dragoon/skills/typography/scripts/typography.js`.