citypaulCommunity·50 Agent Skills Included

.dotfiles

AI coding guidelines for TDD, TypeScript, and clean architecture

Enforces test-driven development, strict TypeScript, and functional programming rules on AI coding agents. Covers testing, refactoring, debugging, API design, architecture review, story splitting, and PR stacking through 40+ on-demand skills. Eliminates vague AI output by giving agents concrete quality gates, decision frameworks, and anti-pattern catalogs. Works with Claude Code, OpenCode, Cursor, and 40+ other coding agents.

723|93

↗

npx skills add citypaul/.dotfiles --all -g -y

Available:

Gives the AI agent its core working rules — mandatory TDD, strict TypeScript, immutable code — and tells it which specialized skill to load for each kind of task.

All Skills in This Repository (50)

Pure Emerald Level Indicators

📦 In Repo

citypaul

technical-writing

Write and verify developer-facing documentation including READMEs, tutorials, reference docs, and release notes.

panel-review

Reviews code diffs by fanning out sub-agents that each apply one installed skill as a review lens.

react-performance

Guides measured, evidence-backed React and Next.js performance optimization workflows.

bff-design

Decide, size, and shape backend-for-frontend services with aggregation, resilience, and identity rules.

storyboard

Generates a single HTML page embedding related UX mocks with audit checklists, flow diagrams, and gap cards.

ubiquitous-language

Enforces one glossary-driven ubiquitous language per bounded context through a five-step naming protocol.

evaluate-existing-solutions

Compares libraries, services, and platform primitives against a bespoke baseline for build-versus-adopt decisions.

characterisation-tests

Write tests that document actual behavior of untested legacy code before refactoring.

diagrams

Create and validate maintainable diagrams in Mermaid, Graphviz, Vega-Lite, and PlantUML.

debugging

Diagnose software failures by testing one causal hypothesis against preserved evidence.

hexagonal-architecture

Implements TypeScript ports and adapters with dependency inversion and domain isolation.

finding-seams

Identifies substitution points in tightly-coupled TypeScript code to make legacy dependencies testable.

Community

Intermediate

Frequently Asked Questions

FAQPage Schema

How to install citypaul/.dotfiles skills?▼

Run `npx skills add citypaul/.dotfiles --all -g -y` in your terminal to install the full skill suite globally.

What does this CLAUDE.md actually do?▼

It sets non-negotiable working rules for your AI agent — test-first development, strict types, immutable data — and routes each task to a detailed skill file loaded only when needed.

Does it work with agents other than Claude Code?▼

Yes. The skills follow the universal SKILL.md standard and install via skills.sh, which supports Claude Code, Cursor, Codex, OpenCode, Gemini CLI, and 40+ other agents.

Which skills are included?▼

Over 40 skills covering TDD, mutation testing, React and front-end testing, API and CLI design, hexagonal architecture, DDD, event sourcing, debugging, CI failures, code review, planning, and story splitting.

Do I need to change how I write code?▼

No. Once installed, your AI agent follows the guidelines automatically; you keep working in plain English while it applies the testing and design rules.