helderberto/agent-skills
Personal SDLC toolbelt for AI coding agents — from PRD to ship.
A collection of skills that encode the workflows, quality gates, and engineering practices I use day-to-day. Pure Markdown, zero runtime deps, installable as a Claude Code plugin or copied into any agent that reads instruction files.
DEFINE PLAN BUILD VERIFY REVIEW SHIP
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Idea │ ────▶ │ Spec │ ─────▶ │ Code │ ──────▶ │ Test │ ──────▶ │ QA │ ──────▶ │ Go │
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
/hb:prd /hb:plan /hb:build /hb:verify-plan /hb:review /hb:ship
Each phase has a dedicated workflow skill that orchestrates the smaller toolbelt skills underneath it. Type the spine in order, or let it chain — every skill auto-routes by description. Only the outward-facing steps that push work out of your hands (ship, create-pull-request) are gated against auto-triggering, so you always pull that trigger yourself.
Quick Start
Claude Code (recommended)
Install via the marketplace:
/plugin marketplace add helderberto/agent-skills
/plugin install hb@helderberto-skills
After install, skills are available as /hb:<skill-name> — e.g. /hb:prd, /hb:tdd, /hb:ship. Most skills also auto-trigger from natural language ("review this PR", "check accessibility", etc.) based on their description.
Gemini CLI
Install as native skills:
gemini skills install https://github.com/helderberto/agent-skills.git --path skills
Skills are auto-discovered and routed by description. See docs/gemini-cli-setup.md.
OpenCode
Clone and point OpenCode at the workspace — AGENTS.md plus the skills/ directory drive auto-routing:
git clone https://github.com/helderberto/agent-skills.git
Open the project in OpenCode. The .opencode/skills symlink and root AGENTS.md are already wired. See docs/opencode-setup.md.
Cursor
Clone the repo, then copy individual skills into .cursor/rules/:
git clone https://github.com/helderberto/agent-skills.git
cp agent-skills/skills/tdd/SKILL.md .cursor/rules/tdd.md
cp agent-skills/skills/code-review/SKILL.md .cursor/rules/code-review.md
See docs/cursor-setup.md for the recommended starter set.
Workflow example — full SDLC walkthrough
A non-trivial feature flows through all six phases. Each workflow skill is one invocation:
You: /hb:prd add dark mode support
AI: Interviews, scans the codebase, writes .specs/prds/dark-mode.md.
Run /hb:plan dark-mode next?
You: /hb:plan dark-mode
AI: Breaks the PRD into phased vertical slices.
Writes .specs/plans/dark-mode.md.
You: /hb:build dark-mode
AI: Implements next incomplete phase. TDD loop, lint, type-check.
Marks checkboxes in the plan. Offers a commit.
You: /hb:verify-plan dark-mode
AI: Verifies plan checkboxes against actual codebase.
Reports total progress and remaining blockers.
You: /hb:review
AI: Detects what changed, runs relevant audits in order
(code-review, a11y-audit, safe-repo, perf-audit, deps-audit, ...).
Consolidates findings into Critical / Important / Suggestion.
You: /hb:ship
AI: Pre-launch gate (validate-code + safe-repo --diff).
Atomic commits, push current branch.
/hb:ship --fast skips the gate (hotfix only).
For quick standalone tasks, you don't need the workflow — just describe what you want and the relevant skill triggers ("write tests for X", "audit deps", "create an ADR for Y").
Skills
Skills come in two modes. User-invoked ones never auto-trigger (disable-model-invocation: true) — reserved for outward-facing, irreversible actions you must pull the trigger on yourself: ship and create-pull-request. Everything else is model-invoked: it auto-routes by description and stays callable explicitly as /hb:<name>. Model-invoked descriptions carry the trigger and anti-trigger clauses routing depends on; the two user-invoked ones keep a single what-it-does sentence, since trigger phrases are dead weight when nothing auto-routes.
'%20stop-opacity%3D'0.16'%2F%3E%3Cstop%20offset%3D'1'%20stop-color%3D'rgb(200%2C90%2C60)'%20stop-opacity%3D'0.03'%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D'320'%20height%3D'200'%20fill%3D'url(%23g)'%2F%3E%3Ccircle%20cx%3D'250'%20cy%3D'56'%20r%3D'92'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.06'%2F%3E%3Ccircle%20cx%3D'64'%20cy%3D'172'%20r%3D'58'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.05'%2F%3E%3C%2Fsvg%3E)
