Updated 2d ago
by rafaelob
pragmatic-agent-skills
Curated, runtime-neutral skills for coding agents (agentskills.io format): pragmatic, XP-minded, evidence-first.
23 GitHub stars (23)
+23 in 14 days
| Period | New stars |
|---|---|
| Oct 7 | +13 |
| Oct 8 | 0 |
| Oct 9 | +1 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | −1 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 22 skills (22 skills found in its SKILL.md files)
- 2 forks (2 forks)
- 2d ago last update (Last updated 2d ago)
Install
Skills CLI
npx skills add rafaelob/pragmatic-agent-skills
Asks which skills and agents to install. Just one: npx skills add rafaelob/pragmatic-agent-skills --skill claude-code-orchestrator — add -g for every project.
Claude Code
git clone https://github.com/rafaelob/pragmatic-agent-skillscp -r "pragmatic-agent-skills/skills/claude-code-orchestrator" ~/.claude/skills/
Copies the claude-code-orchestrator skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add rafaelob/pragmatic-agent-skills
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
claude-code-orchestrator
Use when delegating on Claude Code: select a subagent role, brief the task, and start, stop, resume or reconcile a child. Not for peer sessions or other CLIs. Slicing -> xp-agile-delivery.
skills/claude-code-orchestrator/SKILL.md on GitHub (opens in a new tab) -
code-review
Use when asked to review a diff, PR or uncommitted change for correctness, regressions and unneeded complexity. Not OWASP/authz -> security-review. Not deleting extras -> kill-slop.
skills/code-review/SKILL.md on GitHub (opens in a new tab) -
codebase-design
Use when designing or improving a module's interface (deep modules, small interfaces, clean seams) or finding and assessing shallow modules worth deleting, inlining or deepening. Moves -> refactoring-catalog.
skills/codebase-design/SKILL.md on GitHub (opens in a new tab) -
codex-subagent-routing
Use when delegating on Codex: select an eligible role, brief it as the mission (goal, scope, constraints, acceptance, delivery) and reconcile the delivery. Not for peer sessions or other CLIs.
skills/codex-subagent-routing/SKILL.md on GitHub (opens in a new tab) -
diagnosing-bugs
Use to reproduce a bug from evidence, or a failing test whose code may be wrong, and isolate one cause before changing code. Not proving a seam is wired -> layered-testing-executor.
skills/diagnosing-bugs/SKILL.md on GitHub (opens in a new tab) -
docker-compose
Use when a change must run against the repo's own Compose project (service won't start, ports, volumes). Reuse `docker compose -p <project>`. Test selection -> layered-testing-executor.
skills/docker-compose/SKILL.md on GitHub (opens in a new tab) -
exhaustive-repo-cleanup-audit
Use when asked to audit or clean up a repository, or identify files safe to delete. Audit every file; delete proven junk only when removal is requested. Dead code -> kill-slop.
skills/exhaustive-repo-cleanup-audit/SKILL.md on GitHub (opens in a new tab) -
gemini-cli-orchestrator
Use when delegating on Antigravity (Gemini family): read the dispatch schema, pick the child by task and complexity, brief it as the mission, verify returned work. Not the separate Gemini CLI.
skills/gemini-cli-orchestrator/SKILL.md on GitHub (opens in a new tab) -
grok-build-orchestrator
Use when delegating on Grok Build via spawn_subagent: pick the child by task type and complexity from the live schema and brief it as the mission. Not peer sessions or other CLIs.
skills/grok-build-orchestrator/SKILL.md on GitHub (opens in a new tab) -
kill-slop
Use when code or a diff has unneeded files, dependencies, abstractions (factory of factory) or dead code. Strip them; keep the behavior. Not a PR review -> code-review. Not renames or moves -> legacy-code-change.
skills/kill-slop/SKILL.md on GitHub (opens in a new tab) -
kimi-cli-orchestrator
Use when delegating on Kimi Code CLI: pick the child from its native agent files by task type and complexity, brief it as the mission. Not another runtime's orchestrator, a peer session or another CLI.
skills/kimi-cli-orchestrator/SKILL.md on GitHub (opens in a new tab) -
layered-testing-executor
Use when a changed capability is ready to verify: tests to pick and run, seams to prove reachable, genuine zero vs unknown. Narrowest layer first. Not first failing test -> tdd. Not story Done gate -> xp-agile-delivery.
skills/layered-testing-executor/SKILL.md on GitHub (opens in a new tab) -
legacy-code-change
Use when changing code with no trusted tests (characterize, cut the smallest seam, red then green). Trusted tests -> refactoring-catalog. New code -> tdd. Unknown cause -> diagnosing-bugs.
skills/legacy-code-change/SKILL.md on GitHub (opens in a new tab) -
pragmatic-engineering
Use when an engineering trade-off needs a choice: simplest thing, reversibility, tracer bullet or prototype, DRY, broken windows, estimate uncertainty, "is this over-engineered?". Slicing a story -> xp-agile-delivery.
skills/pragmatic-engineering/SKILL.md on GitHub (opens in a new tab) -
refactoring-catalog
Use when code has real duplication, confusing intent or excess coupling and trusted behavioral tests exist. Gives small safe moves (extract, rename, move), green throughout. No trusted tests -> legacy-code-change.
skills/refactoring-catalog/SKILL.md on GitHub (opens in a new tab) -
security-review
Use for a structured security review: threat modelling, OWASP checks and severity-ranked findings. Not an ordinary correctness pass -> code-review.
skills/security-review/SKILL.md on GitHub (opens in a new tab) -
tdd
Use when about to write code for a feature or bugfix and no failing test exists yet. Red-green-refactor. Layers -> layered-testing-executor. Untested -> legacy-code-change; unknown cause -> diagnosing-bugs.
skills/tdd/SKILL.md on GitHub (opens in a new tab) -
test-audit
Use when adding/changing a test or auditing/pruning low-value, implementation-coupled or duplicate tests. Not red-green -> tdd. Not layer choice -> layered-testing-executor. Untested code to change -> legacy-code-change.
skills/test-audit/SKILL.md on GitHub (opens in a new tab) -
testing-e2e-playwright
Use when writing, fixing or de-flaking a Playwright/e2e browser test: fixtures, locators, waits, user-visible assertions. Not the pre-delivery UI pass.
skills/testing-e2e-playwright/SKILL.md on GitHub (opens in a new tab) -
windows-shell-interop
Use for UnicodeEncodeError, console mojibake (cp1252), PowerShell 5.1 vs 7, or a path/quoting trap across PowerShell, Git Bash, cmd and Windows paths. Not a Linux-only script. Compose volumes -> docker-compose.
skills/windows-shell-interop/SKILL.md on GitHub (opens in a new tab) -
worktree-lifecycle
Use when a second concurrent writer needs an isolated tree, or a git worktree needs census, ownership check or disposal. One owner per tree. Not merge conflicts. Whole-repo cleanup -> exhaustive-repo-cleanup-audit.
skills/worktree-lifecycle/SKILL.md on GitHub (opens in a new tab) -
xp-agile-delivery
Use when a story moves from ready to in-progress, or a mission needs slicing. Beyond one slice: blocked sub-issues via tdd. Not test layers -> layered-testing-executor. Trade-off doubt -> pragmatic-engineering.
skills/xp-agile-delivery/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.