# helderberto/agent-skills

[](https://github.com/helderberto/agent-skills/actions/workflows/test-plugin-install.yml)

**Personal SDLC toolbelt for AI coding agents — from spec 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](https://claude.com/claude-code) plugin or copied into any agent that reads instruction files.

``` SPEC PLAN BUILD TEST REVIEW SHIP ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ Idea │ ────▶ │ Spec │ ─────▶ │ Code │ ──────▶ │ Test │ ──────▶ │ QA │ ──────▶ │ Go │ │Refine│ │Slices│ │ Impl │ │Verify│ │ Gate │ │ Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /hb:spec /hb:plan /hb:build /hb:test /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

<details open> <summary><b>Claude Code (recommended)</b></summary>

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:spec`, `/hb:tdd`, `/hb:ship`. Most skills also auto-trigger from natural language ("review this PR", "check accessibility", etc.) based on their description.

</details>

<details> <summary><b>Gemini CLI</b></su