github.com/agranado2k/agentic-sdlc
| Skill | Added | Review |
|---|---|---|
design-brief .agents/skills/design-brief/SKILL.md Make the shape of the system a recorded strategic act. Read the brief, the glossary and the decision records, design the architecture twice, compare the candidates on complexity, and — after a human yes — record the paradigm, the architectural style, the context map and the patterns adopted or rejected as three anchors in the engineering article, a glossary section, and one decision record. Use at bootstrap hand-back before the first feature diff, when a planner sees the shape no longer fitting, or when `/housekeeping` or the architecture skill raises a style-level red flag. | 65 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 0f5671d | |
diagnose .agents/skills/diagnose/SKILL.md Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression. | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 0f5671d | |
dogfood .agents/skills/dogfood/SKILL.md Walk this project's own personas through its real user-facing surface before a human does — a browser for a web app, the binary for a CLI, a client for an API or a tool server — and report the friction and breakage as candidate tickets. Use when a branch is functionally complete and somebody is about to say "ship it", or when the user asks to dogfood a branch, run an end-to-end pass, or test the changed flows as a user. | 60 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
explain-diff .agents/skills/explain-diff/SKILL.md Produce a rich, interactive, self-contained HTML explanation of a code change — background, intuition with diagrams, a code walkthrough, and a comprehension quiz. Use when the user asks to explain a diff, branch, commit range, or PR, wants to understand a change before reviewing or merging it, or wants to pay down cognitive debt on code an agent wrote. | 72 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
grill-me .agents/skills/grill-me/SKILL.md Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me". | 68 Impact — No eval scenarios have been run Securityby Critical Do not install without reviewing Version: 0f5671d | |
grill-with-docs .agents/skills/grill-with-docs/SKILL.md Grilling session that challenges your plan against the project's documented domain language and decision records, sharpens terminology, and updates the glossary and ADRs inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions. | 67 Impact — No eval scenarios have been run Securityby Critical Do not install without reviewing Version: 0f5671d | |
housekeeping .agents/skills/housekeeping/SKILL.md Run the recurring housekeeping pass — audit the agent files for rot, the glossary against the code, the decision index, the mutation measurement, the worktrees and the diary, then scan the codebase for Ousterhout's red flags and route each finding to the skill that owns it. It never fixes what it finds; findings leave as candidate tickets. Its one write of its own is stamping the diary's Last housekeeping row, and its one delegated action is the worktree pruning it hands to the cleanup skill. Use when the docs gate's housekeeping-due advisory fires, on the cadence the gate config names, or before cutting a release. | 76 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 0f5671d | |
implement .agents/skills/implement/SKILL.md | — | |
improve-codebase-architecture .agents/skills/improve-codebase-architecture/SKILL.md Find deepening opportunities in a codebase — refactors that turn shallow modules into deep ones — informed by the project's domain language and its binding decision records, then grill through whichever one the human picks. Use when an area has become hard to change or hard to test, or when the user asks to improve architecture, consolidate tightly-coupled modules, or make a codebase more navigable. | 66 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
merge-train .agents/skills/merge-train/SKILL.md Serially land a batch of green PRs through the forge's own merge API — migration-aware ordering, update-branch for stale PRs, wait for the post-merge workflows between merges, then run /worktree-cleanup. Invoke as `/merge-train` (discover all green PRs) or `/merge-train <PR#> [<PR#>…]` (explicit batch). Operator-invoked only; complements /pr-iterate, which never merges. | 69 Impact — No eval scenarios have been run Securityby Critical Do not install without reviewing Version: 0f5671d | |
pr-iterate .agents/skills/pr-iterate/SKILL.md One closed-loop iteration on an open PR — read CI checks + bot and human review comments, triage against this repo's decision records, apply valid suggestions, reply with reasoning on rejected ones, push fixes as Conventional Commits, and report status. Invoke as `/pr-iterate <PR#>`. Compose with `/loop /pr-iterate <PR#>` for continuous monitoring until green. | 60 Impact — No eval scenarios have been run Securityby Critical Do not install without reviewing Version: 0f5671d | |
prototype .agents/skills/prototype/SKILL.md Answer a design or feasibility question with explicitly throwaway spike code — never committed, findings recorded in the diary or an ADR draft. Use when a decision is blocked on "would X even work?" (library capability, API behavior, performance shape). Not for building features — that's /tdd via /implement. | 74 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
retro .agents/skills/retro/SKILL.md Run the retrospective over a window of the decision trace — answer eight fixed questions (tier calibration, review signal per sub-agent, recurring failures, diagnosis calibration, spend, chain health, aim calibration, stamp calibration) and turn what recurs into candidate tickets. It is the one skill that reads the trace, and it reads after the fact; it never fixes what it finds and never edits a skill. Use after a wave lands, before a release, or when a wave felt more expensive or more iterative than it should have. | 68 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
review-pr .agents/skills/review-pr/SKILL.md Two-axis senior reviewer. Axis 1 (standards, "is it built right?") runs 6 specialized parallel sub-agents (Security, API/CRUD, Pattern enforcement, Simplicity, Reuse/DRY, Test hygiene) producing a severity-based report. Axis 2 (spec & behavior, "is it the right thing?") runs a 7th fresh-context sub-agent producing a behavior-change confirm-list for the human. Axes are never merged. Scoped to the current branch's diff against the default branch. | 49 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
tdd .agents/skills/tdd/SKILL.md Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development. | 62 Impact — No eval scenarios have been run Securityby Critical Do not install without reviewing Version: 0f5671d | |
to-prd .agents/skills/to-prd/SKILL.md Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context. | 54 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 0f5671d | |
to-tickets .agents/skills/to-tickets/SKILL.md Decompose a PRD issue into tracer-bullet tickets — demoable vertical slices sized to one fresh context window, with blocking edges and autonomy labels, published to the project issue tracker. Use after /to-prd when a build spans more than one session; skip it (use /implement directly) when the whole change fits one context window. | 61 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 0f5671d | |
worktree-cleanup .agents/skills/worktree-cleanup/SKILL.md Prune merged feature worktrees, fast-forward the root checkout's base branch, run the project's post-sync command, and refresh the "Active worktrees" row in docs/diary.md. Invoke as `/worktree-cleanup` (or `/worktree-cleanup --dry-run` to preview). Conservative — never removes dirty or unmerged worktrees. | 69 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 0f5671d |