claude-skills

A collection of Claude Code skills and subagents I build and maintain, kept here so they can be versioned and shared openly. Each skill lives in its own directory with a SKILL.md; subagents live under agents/; some bundle scripts, evals, or reference files.

All skills here are MIT licensed (see LICENSE). Skills that wrap an external tool or service carry a Provenance note in their SKILL.md crediting the upstream project and its license — the MIT license covers the skill content, not the wrapped tools.

New here, or checking what changed? CHANGELOG.md lists each addition with what it does, when to reach for it, and what it deliberately won't do.

Skills

Skill	What it does	Wraps
clear-and-human	Construct, review, score, and rewrite prose so it reads human, not AI	—
hook-and-human	Write, punch up, and review persuasive marketing copy without fabricating	—
cv-and-human	Tailor a CV — or a LinkedIn profile (job-seeker lens) — to pass automated HR/ATS screening and Recruiter search while staying truthful and human — keyword/JD matching, parseability, de-slop, optional red-team	—
cv-evidence-base	Interrogate a CV to recover the evidence that never made it onto the page, and grade which roles you are genuinely credible for — including the ones you are not. Runs before `cv-and-human`, when there is no target role yet	—
c7search	Fetch up-to-date library docs via the `c7search` CLI	Context7 API
markdown-converter	Convert PDF/Office/HTML/media files to Markdown	markitdown (MS, MIT)
nano-banana-pro-json	Generate/edit images (Gemini 3 Pro Image) with structured JSON control + photographic style presets, plus recipes for logos (with a free raster→SVG trace), product/e-commerce shots, and infographics — each with honest boundaries	Google Gemini image API
convert-to-webp	Convert images to WebP for web projects	libwebp `cwebp` / macOS `sips`
social-image-prep	Resize and format images for social platforms	`sips` / ImageMagick / Pillow
terragrunt-skill	Generate, validate, review, and debug Terragrunt 1.x configs (units, stacks, `autoinclude`, CAS, dependencies, AWS/Azure/GCP backends) — tracks current stable v1.1.0, incl. Azure backend gotchas and running only changed units at scale	—
terraform-registry	Provider-agnostic CLI to search/inspect the Terraform Registry via its JSON API (no scraping)	Terraform Registry API
source-snapshot	Fetch external data once into pinned, provenance-stamped artifacts; resilient extractor fallback	markitdown / Defuddle / Readability
dev-fleet	Orchestration playbook driving the agent fleet through build → verify → review → commit	—
report-builder	Build self-contained single-page HTML reports/dashboards from data	Jinja2 / Bootstrap 5 / Chart.js / Plotly
ux-audit	Heuristic usability + accessibility audit of rendered web pages (Nielsen + WCAG 2.2)	—
azadvertizer	Offline lookups over Azure Policy / Initiative / RBAC-Role metadata + cross-references	AzAdvertizer CSV exports
use-linearis	Drive Linear.app from the CLI — issues, milestones, blocked-by relations, release filtering — plus the Linear↔Ogham dogfooding loop	linearis CLI
excalidraw-diagram	Generate Excalidraw diagrams that argue visually, with a render→view→fix loop (engine fetched once from a pinned, sha256-verified release, then offline) and optional cloud-icon (AWS/Azure/GCP) ingestion	Excalidraw (MIT; engine fetched at first render, fonts vendored); design forked from coleam00; icon approach from awesome-copilot (MIT)
travel-planning	Turn a trip into a paced day-by-day itinerary + a reconciled budget (Markdown); grounds cost estimates in typical/seasonal prices (labeled, sourced) — no booking, no live fares	—
business-plan	Build a realistic business plan (full plan + one-pager + investor summary) where every number is researched-and-cited, user-supplied, or computed from your assumptions — never invented; ends with an honest go/no-go/reshape verdict	—

Using these skills

Every skill directory has its own README.md — a plain-English guide to what it does, how to use it well, and, just as importantly, what it does not do. Read that first; a skill's boundaries matter as much as its capabilities, and knowing what a skill deliberately refuses (invent a price, book a trip, predict a fare) is what keeps its output trustworthy.

In Claude Code and claude.ai a skill triggers automatically when your request matches its description — you don't call it by name, you just describe the task. Install one by symlinking its directory (see Install) or by adding its packaged .skill file. This "what it does / what it doesn't do" README is the standard shape for every skill here — new skills ship one too (see CONTRIBUTING.md).

Agents

Subagents for software-development work, coordinated by the dev-fleet skill. Each is a *.md with frontmatter (name, description, tools, model) and a system-prompt body. Architecture and rationale: docs/agent-fleet-architecture.md.

Agent	Role	Model
azure-architect	Enterprise-scale Azure / Cloud Adoption Framework design — governance, subscriptions, networking, IaC review	opus
fact-verifier	Verify claims/code against authoritative sources — cite, refute, or return the lookup; never assert from memory	sonnet
code-builder	Implement scoped changes TDD-style in an isolated worktree; commit on a branch, never push/merge/apply	sonnet
coherence-checker	Structural fit of the implementation vs the plan/spec/verified facts — spec/plan traceability, inverse-pair round-trip (no normalization tricks), cross-impl parity, contract-docstring fidelity; read-only, gated on change complexity	sonnet
code-reviewer	Advisory review for correctness, edge cases, contracts, security, tests — findings ranked by confidence (uncertain ones surfaced, not suppressed), not a gate	sonnet
docs-reviewer	Review docs (READMEs, ADRs, runbooks) for completeness, clarity, correctness, and audience fit	sonnet
ux-auditor	Audit a rendered web page for usability/accessibility; renders via agent-browser/playwright-cli, fans out one per page (reads `ux-audit`)	sonnet
commit-pr	Write commit and PR/MR messages (reads `commit-style`)	haiku
commit-style	Commit/PR style playbook used by `commit-pr`	—

Several agents ship a deterministic behavioral eval under agents/<name>/evals/ (run with uv run python grade.py).

fact-verifier and cv-and-human's red-team Truth lens share one portable verifier contract — never-assert-from-memory, cite/refute/return-the-lookup, read-only — with a per-domain source profile. Write a profile to get a verifier for a new domain without re-deriving the discipline.

Contributing

Authoring or editing a skill? See CONTRIBUTING.md — in particular the
absolute-path + uv convention for invoking a skill's bundled scripts, so they work from any
working directory rather than only this repo's root.

Install

Symlink any skill into your personal skills directory:

ln -s "$(pwd)/clear-and-human" ~/.claude/skills/clear-and-human

Subagents install the same way, into ~/.claude/agents/:

ln -s "$(pwd)/agents/fact-verifier.md" ~/.claude/agents/fact-verifier.md

Symlinking (rather than copying) keeps this repo the single source of truth — edits here are picked up immediately.

Requirements per skill

c7search — the c7search binary (go install github.com/kevin-burns/c7search@latest). A CONTEXT7_API_KEY is optional.
markdown-converter — uv (uses uvx markitdown, no install needed).
nano-banana-pro-json — uv and a GEMINI_API_KEY environment variable. No key is bundled.
convert-to-webp — cwebp (brew install webp) or macOS sips. No install needed on macOS.
social-image-prep — sips (macOS), ImageMagick, or uv (for the Pillow fallback). Uses whichever is present.
terragrunt-skill — works as static review with no tooling; the bundled scripts/validate.sh uses terragrunt (1.x), plus optional tflint and trivy if present. scripts/detect_custom_resources.py runs on Python 3.
terraform-registry — Python 3 (stdlib only). search/inspect-module need only network access; inspect-resource/refresh-schema additionally need the terraform CLI.
source-snapshot — Python 3 (stdlib only). Uses whichever extractor is present: markitdown (via uv, the reliable fallback for docs/tables), and optionally Defuddle for prose articles (it strips page chrome). The producer auto-resolves the Defuddle runner — an installed defuddle binary, else pnpm dlx / bunx / npx defuddle (the defuddle package; defuddle-cli is deprecated/merged into it) — never pinning @latest, so caches are reused. Install once with pnpm add -g defuddle to avoid per-run fetches, or set SNAPSHOT_DEFUDDLE_CMD for a custom path. Degrades gracefully when one is missing.
cv-and-human — no tooling for the core CV workflow (review, tailoring, de-slop). The optional red-team's measured ATS lens uses scripts/ats_adversarial_loop.py — uv/Python 3 (its selftest runs without a model backend). The LinkedIn profile mode uses scripts/li_profile_check.py and needs uv/Python 3.
dev-fleet — no tooling; it's an orchestration playbook for the agents above.
report-builder — uv (the bundled scripts/render.py declares its deps via PEP 723 inline metadata; run with uv run). Bootstrap/Chart.js/Plotly load from CDN, or vendor them for offline reports.
ux-audit / ux-auditor — a browser driver to render pages: prefers agent-browser, falls back to playwright-cli; uses whichever is installed. Degrades to a static-HTML audit (clearly flagged) if neither is present.
use-linearis — the linearis CLI (npm i -g linearis, Node; ships linear and linearis binaries) and a Linear API token via linear auth login. The Ogham dogfooding loop additionally uses the ogham CLI (a local Go binary; hybrid search via ogham search).
excalidraw-diagram — uv plus a one-time uv run playwright install chromium. Fonts are vendored under references/vendor/; the Excalidraw render engine is fetched once on first render from a pinned, sha256-verified GitHub Release (see references/vendor/bundle.lock.json), then cached and served locally — so the first render needs network, subsequent renders are offline. No Node needed at render time; Node + npm are needed only to re-vendor and republish a newer Excalidraw version via references/scripts/vendor.sh. Optional cloud/architecture icons (AWS/Azure/GCP/K8s) use user-supplied .excalidrawlib files ingested by stdlib scripts — no extra tooling; sets aren't bundled (own licenses).
azadvertizer — uv (stdlib-only script via uv run); network only for the one-time fetch. Caches to $XDG_CACHE_HOME/azadvertizer; all queries run offline. Data © Julian Hayward / AzAdvertizer — cache, don't hammer; not republished here.
travel-planning — none to plan (pure instructions). Uses web search, if available, to ground cost estimates in typical/seasonal prices; degrades to a labeled estimate if a lookup fails. Optional: report-builder for an HTML version. It never books or reads live fares — see its README.
business-plan — uv for the stdlib financials helper (scripts/financials.py, no runtime deps, run via uv run). Uses web search, if available, to research and cite market/competitor facts; where research fails it falls back to labeled placeholders rather than inventing. Optional: report-builder for an HTML version. It never invents a market size, competitor price, or revenue figure — see its README.