agent-skills

agent-skills

Skills and subagents for AI coding agents — one source of truth, installed natively in Claude Code, Gemini CLI, OpenAI Codex CLI, and 50+ other agent CLIs through vercel-labs/skills.

Skills encode the workflows a senior engineer follows: research before coding, spec before plan, plan before implement, verify before ship. Packaged so the same workflows trigger across every tool you drive.

Quickstart

npx skills@latest add heyimcarlos/agent-skills

Pick which skills to install and which agents to install them into. The CLI auto-detects supported agent CLIs on your machine and writes SKILL.md files into each one's native skill path.

Claude Code (full plugin)

npx skills add installs skills only. To also pick up the research subagents in agents/, install via Claude Code's plugin marketplace:

/plugin marketplace add heyimcarlos/agent-skills
/plugin install agent-skills@agent-skills

Layout

skills/
  engineering/    # daily code work — git, PRs, planning, implementation, debug
  qrspi/          # the QRSPI workflow as prefixed qrspi-* setup, create, and iterate skills
  misc/           # reserved for rarely-used skills
agents/           # Claude Code subagents (codebase + thoughts + web research)
.claude-plugin/
  plugin.json     # single-plugin manifest read by `npx skills` and Claude Code

QRSPI workflow

Each stage is its own skill, with an iterate-* sibling for surgical adjustments without restarting the workflow.

Stage	Skill	Purpose
Question	qrspi-create-research-questions	Turn a ticket into targeted questions before any code is read
Research	qrspi-create-research	Document the codebase as-is, grounded in real files
Spec	qrspi-create-design-discussion → qrspi-create-structure-outline	Synthesize research into architectural decisions and a phased outline
Plan	qrspi-create-plan	Convert outline into a rigid step-by-step plan with dual verification
Implement	qrspi-create-worktree	Launch an isolated implementation session from an approved plan
Setup	qrspi-setup	Initialize the local thoughts/ workspace used by the QRSPI skills

QRSPI skills use a qrspi- name prefix so they are easy to find and select during installation. They set disable-model-invocation: true — the human invokes each phase deliberately rather than letting the model auto-trigger them.

Every doc-producing QRSPI skill (all of the above except qrspi-create-worktree) accepts an optional --output=html flag. When present, the skill emits a reveal.js slide deck alongside the canonical markdown — color, SVG diagrams, annotated code, comparison tables. Iterate skills detect the sibling .html and refresh both. See skills/qrspi/HTML-OUTPUT.md for the conventions and per-phase slide structures.

Reference

Engineering

Code-work skills — git, PRs, planning, implementation, debug.

• commit — Create focused git commits with user approval
• debug — Debug issues by investigating logs, database state, and git history.
• defragance — Distill the taste, idioms, and operating habits of strong comparables into project guidance.
• deslop — Remove AI-generated code slop and clean up code style.
• find-comparables — Research mature comparable repositories, language standards, and books to extract best practices for a project or rewrite.
• get-pr-comments — Fetch and summarize review comments from the active pull request.
• review-and-ship — Review the current branch for bugs, intent fit, and test coverage; run or write tests; commit focused work; open or update a PR.
• thermo-nuclear-code-quality-review — Run an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth.

QRSPI

The Question → Research → Spec → Plan → Implement workflow as explicit skills.