Skills
Portable, platform-agnostic practices for AI agents.
01 commit-conventions 18 ↓ | v1.3.1
Enforces Conventional Commits format and branch naming conventions, validating commit message structure (type/scope/description header), suggesting branch name patterns (feature/*, fix/*, hotfix/*), and enforcing breaking change notation.
02 create-adr 11 ↓ | v1.2.1
Detects architectural decisions in conversation and guides creation of Architecture Decision Records.
Activate when the user is making, discussing, or debating: technology choices (languages, frameworks, databases, cloud services), structural patterns (monolith vs microservices, event-driven, CQRS, API design), cross-cutting conventions (error handling, logging, authentication, API versioning), hard-to-reverse decisions (data models, public API contracts, infrastructure topology), or deviations from existing standards. Also activate when the user explicitly asks to create an ADR.
03 create-profile 11 ↓ | v1.1.0
Creates agent profiles that define roles with scoped permissions and constraints.
Investigates the repo for existing profiles and conventions, writes a focused profile markdown file, and validates scope boundaries. Use when the user wants to create an agent profile, define a specialized role, scope an agent to specific files or domains, set up a new team member persona, restrict what an agent can touch, or wants consistent behavior from a domain-specific agent.
04 create-rule 13 ↓ | v1.2.1
Creates rule files that define always-on constraints for agent sessions.
Investigates the repo for existing conventions, writes a RULE.md with clear structure, and validates against real usage. Use when the user wants to create a rule, add a convention, enforce a standard, establish a project-wide constraint, define coding style, standardize formatting across generated files, notices inconsistent output across sessions, or is setting up a new project's conventions.
05 create-skill 7 ↓ | v1.3.0
Creates new agent skills following the Agent Skills specification.
Investigates the repo for conventions, designs the skill around progressive disclosure, writes SKILL.md with effective trigger descriptions, and validates with representative prompts. Use when the user wants to create a skill, build a SKILL.md, turn a workflow into a reusable skill, teach the agent a new task, scaffold a new agent capability, has a repeated workflow they want to codify, is frustrated by inconsistent agent behavior, or wants to package expertise for a team.
06 git-worktree 7 ↓ | v1.0.1
Creates, lists, and removes git worktrees to manage parallel workspaces.
Activate when the user needs to work on multiple branches simultaneously, run parallel tasks in isolation, or when an agent needs its own workspace. Also activate when the user says "worktree", "parallel branch", "work on two things at once", or "run these in parallel".
07 github-create-pr 5 ↓ | v1.0.0
Creates a pull request using GitHub CLI by following every numbered step in order.
Do not skip steps. Do not improvise — execute the workflow literally. Activate when the user says "create PR", "open PR", "push and PR", "submit for review", or work is ready for review.
08 grill-me 17 ↓ | v1.0.1
Challenge a plan, spec, ADR, or design by interviewing the user relentlessly until all corners are covered.
Identifies edge cases, questions assumptions, probes failure modes, and surfaces missing requirements. Use when the user wants to stress-test a plan, get grilled on their design, says "grill me", "challenge this", or "poke holes in this."
09 grill-with-docs 6 ↓ | v1.0.0
Domain-driven grilling session that challenges a plan against the project's language, sharpens terminology, and writes documentation inline as decisions crystallise.
Use when the user wants to stress-test a plan against domain language, says "grill with docs", "sharpen terms", "challenge against domain", or wants a grilling session that produces glossary updates and ADRs as it goes.
10 makefile-conventions 14 ↓ | v1.0.1
Structures Makefiles as a universal command interface using modular includes and self-documenting help.
Use when the user wants to add a make target, create a Makefile, organize build commands, set up a make-based workflow, or asks how to structure make targets. Also activate before modifying any Makefile or mk/ file in this project.
11 spec-workflow 9 ↓ | v1.1.1
Drives feature development through a phased workflow: specify requirements, design architecture, break into tasks, then implement autonomously with frequent commits.
TRIGGER CHECK: Before starting any new task, ask yourself — does this touch 3+ files, add dependencies, change infrastructure, or require trade-off decisions? If yes, activate this skill. Also activate when the user says "let's spec this", "new feature", or "let's plan."