citypaul/.dotfiles

1

front-end-testing Behavior-driven UI testing patterns across Vitest Browser Mode, Playwright E2E evidence boundaries, and DOM Testing L…

citypaul/.dotfiles

235

2

react-testing React component testing patterns including components, hooks, context, and forms. Covers Vitest Browser Mode with vit…

citypaul/.dotfiles

232

3

refactoring Refactoring assessment and behavior-preserving patterns for code with a passing baseline and proportionate preservati…

citypaul/.dotfiles

222

4

typescript-strict TypeScript strict mode patterns including schema-first development, branded types, type vs interface guidance, and ts…

citypaul/.dotfiles

216

5

teach-me Structured learning and tutoring for any topic. Use when the user wants to learn a concept, be quizzed, create a lear…

citypaul/.dotfiles

213

6

tdd RED-GREEN-REFACTOR for production behavior changes, followed by mutation testing or alternate evidence once at the en…

citypaul/.dotfiles

211

7

testing Testing patterns for behavior-driven tests. Use when writing tests, creating test factories, structuring test files, …

citypaul/.dotfiles

208

8

twelve-factor Twelve-Factor App patterns for software-as-a-service and long-running process applications. Use when configuring depl…

citypaul/.dotfiles

205

9

cli-design Unix-composable CLI design patterns. Use when building CLI tools, designing command trees, implementing output layers…

citypaul/.dotfiles

200

10

functional Functional programming patterns with immutable data. Use when writing logic, data transformations, or encountering mu…

citypaul/.dotfiles

198

11

hexagonal-architecture Use when the user or project explicitly adopts hexagonal (ports and adapters) architecture — a README, CLAUDE.md, or …

citypaul/.dotfiles

198

12

planning Planning work as vertical slices or an explicitly selected mechanism-reduction program in small, known-good increment…

citypaul/.dotfiles

198

13

diagrams Create or audit maintainable diagrams when relationships, sequence, state, hierarchy, or quantitative comparisons are…

citypaul/.dotfiles

197

14

api-design Stable consumer-facing API and interface design patterns. Use when designing REST endpoints, cross-team boundaries, o…

citypaul/.dotfiles

196

15

domain-driven-design Domain-Driven Design patterns for TypeScript. Use when implementing ubiquitous language, value objects, entities, agg…

citypaul/.dotfiles

189

16

mutation-testing Set up and run mutation testing with Stryker, including full-project and focused diff runs against the current review…

citypaul/.dotfiles

189

17

expectations Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fre…

citypaul/.dotfiles

188

18

storyboard Produce a mock-audit storyboard — a single HTML page embedding related UX surfaces side-by-side, with per-mock audit …

citypaul/.dotfiles

187

19

find-gaps Adversarially review an existing written artifact — stories, plans, acceptance criteria, specs, or design mocks — to …

citypaul/.dotfiles

180

20

test-design-reviewer Review test quality using Dave Farley's eight properties of good tests. Use when assessing a test file or suite for u…

citypaul/.dotfiles

180

21

characterisation-tests Use when modifying existing code that lacks tests and you need to document its actual current behavior before making …

citypaul/.dotfiles

176

22

ci-debugging Systematic CI/CD failure diagnosis using hypothesis-first investigation, local reproduction, and environment delta an…

citypaul/.dotfiles

176

23

find-skills Discover and, with authorization, install agent skills from the open skills ecosystem. Use when the user explicitly a…

citypaul/.dotfiles

175

24

finding-seams Use when existing code has untestable dependencies that prevent writing tests -- direct construction of collaborators…

citypaul/.dotfiles

170

25

production-parity-skill-builder Create an application-specific production parity skill by inspecting an app's docs, source, tests, CI, deployment, in…

citypaul/.dotfiles

143

26

story-splitting Turn broad requirements, large stories, epics, features, initiatives, or backlog items into small end-to-end child st…

citypaul/.dotfiles

137

27

folder-structure Deprecated compatibility alias for structure-codebase. Activate only for the exact legacy name folder-structure or an…

citypaul/.dotfiles

127

28

double-check Get a rigorous read-only second opinion on finished work through the host's available reviewer capabilities, preferab…

citypaul/.dotfiles

74

29

structure-codebase Design, audit, and evolve physical source and package structures that expose real architectural boundaries while keep…

citypaul/.dotfiles

72

30

event-sourcing Event sourcing patterns for functional TypeScript — persist state as an append-only log of past events and rebuild it…

citypaul/.dotfiles

68

31

observability Observability as an engineering discipline — wide events / canonical log lines, OpenTelemetry instrumentation (traces…

citypaul/.dotfiles

66

32

ubiquitous-language One ubiquitous language per bounded context, with a repository-declared glossary as the naming authority and explicit…

citypaul/.dotfiles

66

33

specification Turn fuzzy intent into shared understanding and acceptance criteria — specification as a conversation, run one questi…

citypaul/.dotfiles

65

34

evaluate-existing-solutions Research and compare established libraries, open-source tools and applications, managed services, and standard, frame…

citypaul/.dotfiles

64

35

reduce-system-complexity Reduce total mechanism in a selected existing system or behavior path while conserving its agreed observable behavior…

citypaul/.dotfiles

63

36

technical-writing Writing developer-facing prose that can be skimmed first and trusted enough to finish — READMEs, guides, tutorials, r…

citypaul/.dotfiles

60

37

codebase-design Design and evaluate deep modules: cohesive responsibility behind a small, stable caller-facing contract, with informa…

citypaul/.dotfiles

59

38

secure-oauth-oidc Design, implement, audit, test, troubleshoot, or migrate secure OAuth 2.0 and OpenID Connect (OIDC) systems using RFC…

citypaul/.dotfiles

59

39

improve-codebase-architecture Audit an existing repository or multi-module subsystem for evidence-backed architecture improvements, rank bounded ca…

citypaul/.dotfiles

56

40

bff-design Decide whether a system needs a backend-for-frontend, how many, and what each one may own: adoption signals and hones…

citypaul/.dotfiles

51

41

bff-entry-points Design and protect browser-facing BFF and backend HTTP entry points: an explicit public/protected access classificati…

citypaul/.dotfiles

51

42

stack-pull-requests Decide whether planned vertical implementation work should ship as independent pull requests or as a stack of small o…

citypaul/.dotfiles

43

43

acceptance-review WHEN deciding whether a PR, branch, diff, or current implementation satisfies an authoritative issue, specification, …

citypaul/.dotfiles

16

44

debugging WHEN diagnosing a reproducible or observable software failure outside a CI-pipeline-specific workflow; NOT for specul…

citypaul/.dotfiles

13

45

wtf Re-explain the immediately previous LLM response when it did not land, using plain, precise UK English.

citypaul/.dotfiles

13

46

graph-engineering Compose installed agent skills into one orchestrated multi-agent run: an agent graph where each node is a sub-agent t…

citypaul/.dotfiles

9

47

panel-review Composable multi-agent code review of any change boundary — the working tree mid-development, a branch diff, a stacke…

citypaul/.dotfiles

8

48

frontend-design Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks …

citypaul/.dotfiles

3

49

react-performance Make React and Next.js performance changes that are measured, evidence-backed, and behaviorally safe. Routes to the r…

citypaul/.dotfiles

2

50

render-code-shape Render the shape of code — module boundaries, the types that cross them, signatures, and a cited call graph — for cod…

citypaul/.dotfiles

2