# Agent Skills Collection

A collection of AI agent skills following the [Agent Skills](https://agentskills.io) open format. These skills extend AI coding agents with specialized capabilities and domain knowledge.

## Available Skills

<!-- SKILLS-TABLE:START -->
### Curated Skills

| Skill | Description |
|-------|-------------|
| [debug](skills/.curated/debug) | Comprehensive debugging methodology for finding and fixing bugs |
| [expo-ui](skills/.curated/expo-ui) | Library reference for @expo/ui SwiftUI components on iOS — covers Host boundaries, modifier.. |
| [expo](skills/.curated/expo) | Expo React Native performance optimization guidelines |
| [feature-arch](skills/.curated/feature-arch) | React feature-based architecture guidelines for scalable applications |
| [ios-taste](skills/.curated/ios-taste) | Designs iOS 18+ SwiftUI experiences with real taste — starting from user goals, not pixels |
| [msw](skills/.curated/msw) | MSW (Mock Service Worker) best practices for API mocking in tests |
| [mui-base](skills/.curated/mui-base) | MUI Base UI style guidelines for building headless React component libraries |
| [nextjs](skills/.curated/nextjs) | Next.js 16 App Router performance, caching, server components, server actions, routing, and.. |
| [nuqs-codemod-runner](skills/.curated/nuqs-codemod-runner) | Use this skill whenever a codebase has nuqs code that may be stuck on pre-v2.5 patterns —.. |
| [nuqs-scaffolder](skills/.curated/nuqs-scaffolder) | Use this skill whenever you need to add URL-state filters to a Next.js page, build a typed.. |
| [nuqs](skills/.curated/nuqs) | nuqs (type-safe URL query state) best practices for Next.js and other React frameworks |
| [playwright](skills/.curated/playwright) | Playwright testing best practices for Next.js applications |
| [python](skills/.curated/python) | Python 3.11+ performance optimization guidelines |
| [rails-dev](skills/.curated/rails-dev) | Ruby on Rails performance and maintainability optimization guidelines for building backend APIs.. |
| [rails-testing](skills/.curated/rails-testing) | Ruby on Rails testing best practices for writing effective, maintainable test suites with RSpec |
| [react-19-component-scaffolder](skills/.curated/react-19-component-scaffolder) | Use this skill whenever scaffolding new React 19 / React 19.2 code in TypeScript — components,.. |
| [react-hook-form-audit](skills/.curated/react-hook-form-audit) | Use this skill to audit a Next.js (App Router, 14/15+) codebase for React Hook Form.. |
| [react-hook-form](skills/.curated/react-hook-form) | React Hook Form performance optimization for client-side form validation using useForm,.. |
| [react](skills/.curated/react) | React 19/19.2 modern patterns for concurrent rendering, Server Components, actions, ref-as-prop,.. |
| [refactor](skills/.curated/refactor) | Code refactoring best practices based on Martin Fowler's catalog and Clean Code principles |
| [restful-hateoas](skills/.curated/restful-hateoas) | RESTful API design guidelines following the Richardson Maturity Model through to Level 3.. |
| [ruby-optimise](skills/.curated/ruby-optimise) | Ruby performance optimization guidelines |
| [ruby-refactor](skills/.curated/ruby-refactor) | Ruby refactoring guidelines from community best practices |
| [rust-implement](skills/.curated/rust-implement) | "Write production-grade Rust code using a multi-pass approach |
| [rust-refactor](skills/.curated/rust-refactor) | Decision frameworks for Rust refactoring, simplification, module decomposition, and incremental.. |
| [rust-write-tests](skills/.curated/rust-write-tests) | Skill for writing expert-level Rust tests |
| [shadcn](skills/.curated/shadcn) | shadcn/ui component library best practices and patterns |
| [skill-authoring](skills/.curated/skill-authoring) | Design and development best practices for Claude Code skills, MCP tools, and AI agent capabilities |
| [tailwind](skills/.curated/tailwind) | Tailwind CSS v4 performance optimization and best practices guidelines |
| [tanstack-query](skills/.curated/tanstack-query) | TanStack Query v5 performance optimization for data fetching, caching, mutations, and query patterns |
| [tdd](skills/.curated/tdd) | Test-Driven Development methodology and red-green-refactor workflow |
| [terminal-ui](skills/.curated/terminal-ui) | Terminal User Interface (TUI) performance and UX guidelines for TypeScript applications using.. |
| [think](skills/.curated/think) | Deep strategic thinking mode that finds the single highest-leverage, most innovative action by.. |
| [typescript](skills/.curated/typescript) | This skill should be used when the user asks to "optimize TypeScript performance", "speed up tsc.. |
| [ui-design](skills/.curated/ui-design) | UI/UX and frontend design best practices guidelines |
| [vitest](skills/.curated/vitest) | Vitest testing framework patterns for test setup, async testing, mocking with vi.*, snapshots,.. |
| [web-taste](skills/.curated/web-taste) | Designs React 19 + Next.js 16 + Tailwind CSS experiences with real taste — starting from user.. |
| [zod](skills/.curated/zod) | Zod schema validation best practices for type safety, parsing, and error handling |

### Experimental Skills

| Skill | Description |
|-------|-------------|
| [12-factor-app](skills/.experimental/12-factor-app) | The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications |
| [37signals-rails](skills/.experimental/37signals-rails) | 37signals Rails coding principles and conventions from DHH, Jorge Manrubia, and the.. |
| [acceptance-pipeline-catalog](skills/.experimental/acceptance-pipeline-catalog) | Use when implementing, reviewing, or debugging a Gherkin acceptance-test pipeline with mutation.. |
| [acceptance-pipeline-feature-design](skills/.experimental/acceptance-pipeline-feature-design) | Use this skill when designing new features, extensions, or modifications to Uncle Bob's.. |
| [algorithmic-complexity-review](skills/.experimental/algorithmic-complexity-review) | Use this skill whenever writing, reviewing, or refactoring code where algorithmic complexity.. |
| [app-planner](skills/.experimental/app-planner) | Produces a design-plan (living document like an exec-plan) that maps an app domain to feature.. |
| [ast-grep](skills/.experimental/ast-grep) | ast-grep rule writing and usage best practices |
| [audio-voice-recovery](skills/.experimental/audio-voice-recovery) | Audio forensics and voice recovery guidelines for CSI-level audio analysis |
| [base-ui-migrator](skills/.experimental/base-ui-migrator) | Use this skill whenever the user wants to migrate React UI code to Base UI (`@base-ui/react`) —.. |
| [better-auth-scaffold](skills/.experimental/better-auth-scaffold) | Use this skill whenever scaffolding a Better Auth setup in a Next.js (App Router) + Drizzle.. |
| [better-auth](skills/.experimental/better-auth) | Use this skill whenever writing, reviewing, or migrating Better Auth code in TypeScript —.. |
| [bug-review](skills/.experimental/bug-review) | Use this skill when a user asks to review a pull request for bugs, wants AI code review focused.. |
| [build-mcp-server](skills/.experimental/build-mcp-server) | This skill should be used when the user asks to "build an MCP server", "create an MCP", "make an.. |
| [chat-apps-ui-sdk](skills/.experimental/chat-apps-ui-sdk) | Use this skill whenever building, reviewing, or designing apps that render interactive UI.. |
| [chrome-extension-ui](skills/.experimental/chrome-extension-ui) | Chrome Extensions UX/UI design and implementation guidelines for popups, side panels, content.. |
| [chrome-extension](skills/.experimental/chrome-extension) | Chrome Extensions (Manifest V3) performance and code quality guidelines |
| [clean-architecture](skills/.experimental/clean-architecture) | Clean Architecture principles and best practices from Robert C |
| [clean-code-ts-react](skills/.experimental/clean-code-ts-react) | Use when writing, reviewing, or refactoring TypeScript or React code for craftsmanship — naming,.. |
| [clean-code](skills/.experimental/clean-code) | Use when writing, reviewing, or refactoring code for maintainability and readability |
| [cli-for-agents](skills/.experimental/cli-for-agents) | Use this skill whenever designing, building, or reviewing a command-line tool that AI agents or.. |
| [cli-review-runner](skills/.experimental/cli-review-runner) | Use this skill whenever reviewing, auditing, or grading a command-line tool for.. |
| [code-map-visualization](skills/.experimental/code-map-visualization) | Use this skill whenever rendering, styling, or making interactive a visualisation of a codebase.. |
| [code-simplifier](skills/.experimental/code-simplifier) | Code simplification skill for improving clarity, consistency, and maintainability while.. |
| [codebase-comprehension-algorithms](skills/.experimental/codebase-comprehension-algorithms) | Use this skill whenever mapping an unfamiliar codebase into feature/business domains — answering.. |
| [codemod-react-pipeline](skills/.experimental/codemod-react-pipeline) | Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases |
| [codemod](skills/.experimental/codemod) | Codemod (JSSG, ast-grep, workflows) best practices for writing efficient, safe, and maintainable.. |
| [codex-goals](skills/.experimental/codex-goals) | Patterns and anti-patterns for using OpenAI Codex Goals — the persistent objectives feature.. |
| [complexity-optimizer](skills/.experimental/complexity-optimizer) | Analyze a software codebase for algorithmic complexity and performance hotspots, then propose or.. |
| [computer-science-algorithms](skills/.experimental/computer-science-algorithms) | Use this skill whenever choosing or implementing an algorithm or data structure — covers.. |
| [design-to-react-algorithms](skills/.experimental/design-to-react-algorithms) | Use this skill whenever reverse-engineering a Sketch file (or Figma export with similar shape).. |
| [dev-rfc](skills/.experimental/dev-rfc) | Create well-structured RFCs and technical proposals for software projects |
| [diagram-quality](skills/.experimental/diagram-quality) | Use this skill whenever calling agent-uml MCP tools (design_create, diagram_upsert,.. |
| [django-recommender-search-backend-patterns](skills/.experimental/django-recommender-search-backend-patterns) | Use this skill when building, reviewing, or refactoring a Django backend that fan-outs to.. |
| [dockerfile-optimise](skills/.experimental/dockerfile-optimise) | Dockerfile optimization guidelines from official Docker documentation |
| [domain-architect](skills/.experimental/domain-architect) | Discovers business domains in a Swift codebase by tracing what users can DO — not by reading.. |
| [drizzle-sqlite-scaffold](skills/.experimental/drizzle-sqlite-scaffold) | Use this skill whenever scaffolding Drizzle ORM + SQLite boilerplate — a new.. |
| [drizzle-sqlite](skills/.experimental/drizzle-sqlite) | Use this skill whenever writing, reviewing, or refactoring Drizzle ORM code targeting SQLite.. |
| [dx-harness](skills/.experimental/dx-harness) | Use this skill whenever the user mentions developer-experience friction, slow onboarding,.. |
| [effect-ts](skills/.experimental/effect-ts) | Use this skill whenever writing, reviewing, debugging, or refactoring TypeScript code that uses.. |
| [emilkowal-animations](skills/.experimental/emilkowal-animations) | Emil Kowalski's animation best practices for web interfaces |
| [eval-mcp](skills/.experimental/eval-mcp) | Use this skill when the user asks to "evaluate MCP tools", "test tool selection", "improve tool.. |
| [exec-plan](skills/.experimental/exec-plan) | Manage the lifecycle of ExecPlans — self-contained, living specifications for multi-step work |
| [expo-ios-hig-verify](skills/.experimental/expo-ios-hig-verify) | Use this skill to verify that an Expo / React Native iOS app follows Apple Human Interface.. |
| [expo-ios-hig](skills/.experimental/expo-ios-hig) | Use this skill whenever building, reviewing, or refactoring an Expo / React Native app's iOS.. |
| [expo-ios-screen-scaffolder](skills/.experimental/expo-ios-screen-scaffolder) | Use this skill to scaffold new Expo (React Native) iOS screens that follow Apple Human Interface.. |
| [expo-react-native-coder](skills/.experimental/expo-react-native-coder) | Comprehensive Expo React Native feature development guide |
| [expo-react-native-performance](skills/.experimental/expo-react-native-performance) | Expo React Native performance optimization guidelines |
| [feature-spec](skills/.experimental/feature-spec) | Feature specification and planning guidelines for software engineers |
| [framer-motion](skills/.experimental/framer-motion) | Framer Motion performance optimization guidelines |
| [geohash-spatial-code-maps](skills/.experimental/geohash-spatial-code-maps) | Use this skill whenever implementing, reviewing, or debugging geohash encoding/decoding in.. |
| [graph-schema](skills/.experimental/graph-schema) | Graph database schema design and data modeling expert |
| [harness-engineering](skills/.experimental/harness-engineering) | Set up or update the agent-first engineering harness for any repository |
| [human-copywrite](skills/.experimental/human-copywrite) | Use this skill whenever writing, editing, or reviewing user-facing copy — UI strings,.. |
| [humanize](skills/.experimental/humanize) | Remove signs of AI-generated writing from text |
| [implementation-design-patterns-python](skills/.experimental/implementation-design-patterns-python) | Implementation guide for the 22 Gang of Four design patterns in idiomatic modern Python (3.10+),.. |
| [implementation-design-patterns](skills/.experimental/implementation-design-patterns) | Implementation guide for the 22 Gang of Four design patterns in TypeScript, distilled from.. |
| [inngest-nextjs-patterns](skills/.experimental/inngest-nextjs-patterns) | Use this skill whenever scaffolding Inngest event-driven functions in a Next.js (App Router).. |
| [io-bound-data-processing](skills/.experimental/io-bound-data-processing) | Use this skill when processing, transforming, or moving datasets that may exceed RAM on a single.. |
| [ios-animations](skills/.experimental/ios-animations) | Clinic-architecture-aligned iOS animation craft guidelines for SwiftUI (iOS 26 / Swift 6.2).. |
| [ios-chaos-monkey](skills/.experimental/ios-chaos-monkey) | Crash-hunter skill for iOS 26 / Swift 6.2 clinic-architecture codebases that finds and fixes.. |
| [ios-design-system](skills/.experimental/ios-design-system) | Clinic-architecture-aligned iOS design system engineering for SwiftUI (iOS 26 / Swift 6.2).. |
| [ios-design](skills/.experimental/ios-design) | SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular.. |
| [ios-hig](skills/.experimental/ios-hig) | Apple Human Interface Guidelines for iOS 26 / Swift 6.2 clinic-architecture apps |
| [ios-navigation](skills/.experimental/ios-navigation) | Opinionated SwiftUI navigation enforcement for iOS 26 / Swift 6.2 clinic modular MVVM-C apps |
| [ios-storyboard](skills/.experimental/ios-storyboard) | Legacy interoperability skill for Storyboard and Interface Builder maintenance in iOS 26 / Swift.. |
| [ios-testing](skills/.experimental/ios-testing) | Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications |
| [ios-ui-refactor](skills/.experimental/ios-ui-refactor) | Principal-level SwiftUI UI review and refactoring patterns for iOS 26 / Swift 6.2.. |
| [ios-xcode](skills/.experimental/ios-xcode) | Xcode setup and tooling guidance for iOS 26 / Swift 6.2 clinic modular MVVM-C projects covering.. |
| [js-google](skills/.experimental/js-google) | JavaScript style and best practices based on Google's official JavaScript Style Guide |
| [jscodeshift](skills/.experimental/jscodeshift) | jscodeshift codemod development best practices from Facebook/Meta |
| [knip-deadcode](skills/.experimental/knip-deadcode) | Knip dead code detection best practices for JavaScript and TypeScript projects |
| [linguistic-semantic-algorithms](skills/.experimental/linguistic-semantic-algorithms) | Use this skill whenever mapping out an unfamiliar codebase, hunting bugs across many files,.. |
| [marketplace-personalisation](skills/.experimental/marketplace-personalisation) | Use this skill whenever designing, building, debugging, reviewing, or improving a.. |
| [marketplace-pre-member-personalisation](skills/.experimental/marketplace-pre-member-personalisation) | Use this skill whenever designing, building, reviewing, or diagnosing the pre-member journey of.. |
| [marketplace-recsys-feature-engineering](skills/.experimental/marketplace-recsys-feature-engineering) | Use this skill whenever deciding what features to extract from raw marketplace assets — listing.. |
| [marketplace-search-recsys-planning](skills/.experimental/marketplace-search-recsys-planning) | Use this skill whenever planning, designing, reviewing, or improving search and recommendation.. |
| [nextjs-bundle-optimizer](skills/.experimental/nextjs-bundle-optimizer) | Use this skill whenever a Next.js 16 app needs smaller bundles or faster builds — even if the.. |
| [nextjs-supabase-saas-patterns](skills/.experimental/nextjs-supabase-saas-patterns) | Use this skill whenever writing, reviewing, or refactoring Next.js + Supabase SaaS code that.. |
| [nginx-c-module-debug](skills/.experimental/nginx-c-module-debug) | nginx C module debugging guidelines based on the official nginx development guide |
| [nginx-c-module-design](skills/.experimental/nginx-c-module-design) | nginx C module directive design guidelines for creating admin-friendly configuration interfaces |
| [nginx-c-module-perf](skills/.experimental/nginx-c-module-perf) | nginx C module performance optimization and reliability guidelines based on the official nginx.. |
| [nginx-c-modules](skills/.experimental/nginx-c-modules) | nginx C module development guidelines based on the official nginx development guide |
| [openai-codex-rust-patterns](skills/.experimental/openai-codex-rust-patterns) | OpenAI Codex Rust coding patterns distilled from the codex-rs workspace |
| [opencode-ts](skills/.experimental/opencode-ts) | Write and refactor TypeScript code in repos that use Effect-TS services, Zod schemas,.. |
| [opensearch-function-scoring-algorithms](skills/.experimental/opensearch-function-scoring-algorithms) | Use this skill when designing, tuning, reviewing, or evaluating search relevance and ranking for.. |
| [opensearch-personalize-caching-strategies](skills/.experimental/opensearch-personalize-caching-strategies) | Use this skill when designing, tuning, reviewing, or debugging caching in front of AWS.. |
| [orval](skills/.experimental/orval) | Orval OpenAPI TypeScript client generation best practices |
| [pulumi](skills/.experimental/pulumi) | Pulumi infrastructure as code performance and reliability guidelines |
| [rails-application-ui-blocks](skills/.experimental/rails-application-ui-blocks) | Compose new Rails backend pages and refactor existing Rails UI to use premium blocks from.. |
| [rails-design-system](skills/.experimental/rails-design-system) | Ruby on Rails design system guidelines for building consistent, maintainable UI with minimal.. |
| [rails-hotwire](skills/.experimental/rails-hotwire) | Ruby on Rails Hotwire best practices for building interactive applications with Turbo Drive,.. |
| [react-fetch-cache-patterns](skills/.experimental/react-fetch-cache-patterns) | Use this skill whenever building, reviewing, or refactoring React components that fetch data.. |
| [react-native-elements](skills/.experimental/react-native-elements) | React Native Elements UI component library best practices for performance, theming, and proper.. |
| [react-optimise](skills/.experimental/react-optimise) | Application-level React performance optimization covering React Compiler mastery, bundle.. |
| [react-refactor](skills/.experimental/react-refactor) | Architectural refactoring guide for React applications covering component architecture, state.. |
| [react-testing-library](skills/.experimental/react-testing-library) | React Testing Library best practices for writing maintainable, user-centric tests |
| [same-results-less-code](skills/.experimental/same-results-less-code) | Use this skill whenever reviewing, refactoring, or simplifying code with the goal of producing.. |
| [shell](skills/.experimental/shell) | Shell scripting best practices for writing safe, portable, and maintainable bash/sh scripts |
| [storybook](skills/.experimental/storybook) | Use whenever creating, configuring, or extending Storybook for a TS/React component library —.. |
| [stripe-inspired-api-design-rules](skills/.experimental/stripe-inspired-api-design-rules) | Use this skill whenever designing, reviewing, or refactoring a JSON HTTP API — covers resource.. |
| [swift-data](skills/.experimental/swift-data) | SwiftData persistence and data-layer architecture for iOS 26 / Swift 6.2 clinic modular MVVM-C apps |
| [swift-optimise](skills/.experimental/swift-optimise) | Swift 6.2 and SwiftUI performance optimization for iOS 26 clinic architecture codebases |
| [swift-refactor](skills/.experimental/swift-refactor) | Swift and SwiftUI refactoring patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C.. |
| [swift-ui-architect](skills/.experimental/swift-ui-architect) | Opinionated SwiftUI architecture enforcement for iOS 26 / Swift 6.2 clinic modular MVVM-C apps.. |
| [tailwind-refactor](skills/.experimental/tailwind-refactor) | Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup |
| [tailwind-responsive-ui](skills/.experimental/tailwind-responsive-ui) | Responsive UI transformation patterns for Tailwind CSS applications |
| [tailwind-ui-refactor](skills/.experimental/tailwind-ui-refactor) | Refactoring UI design patterns for Tailwind CSS applications |
| [threat-model](skills/.experimental/threat-model) | Use this skill whenever performing security threat modeling, attack surface mapping, or trust.. |
| [threat-patch](skills/.experimental/threat-patch) | Use this skill to remediate security findings by producing minimal, surgical code patches |
| [ts-google](skills/.experimental/ts-google) | Google TypeScript style guide for writing clean, consistent, type-safe code |
| [typescript-advanced-patterns](skills/.experimental/typescript-advanced-patterns) | Use this skill when writing, reviewing, or designing advanced TypeScript code — type-level.. |
| [typescript-refactor](skills/.experimental/typescript-refactor) | TypeScript refactoring and modernization guidelines from a principal specialist perspective |
| [uniwind](skills/.experimental/uniwind) | Uniwind best practices for React Native styling with Tailwind CSS |
| [unix-cli](skills/.experimental/unix-cli) | UNIX command-line interface guidelines for building tools that follow POSIX conventions, proper.. |
| [vhs](skills/.experimental/vhs) | VHS terminal recording best practices from Charmbracelet |
| [vite](skills/.experimental/vite) | Vite performance optimization guidelines |
| [web-rules](skills/.experimental/web-rules) | Strict design and UX rules for React 19 + Next.js 16 (App Router) + Tailwind CSS 4 |
| [webpack-plugin-authoring](skills/.experimental/webpack-plugin-authoring) | Use this skill whenever writing, reviewing, or debugging webpack 5 plugins — covers hook.. |
| [webpack-plugin-recipes](skills/.experimental/webpack-plugin-recipes) | Use whenever you face a webpack-build problem that ends with needing to write a plugin — 26.. |
| [wxt-browser-extensions](skills/.experimental/wxt-browser-extensions) | WXT browser extension performance optimization guidelines |
| [zustand](skills/.experimental/zustand) | Zustand state management best practices for React applications |
<!-- SKILLS-TABLE:END -->

## Installation

Install skills using Vercel's [add-skill](https://github.com/vercel-labs/add-skill) CLI:

```bash
# Install all skills
npx add-skill pproenca/dot-skills

# List available skills
npx add-skill pproenca/dot-skills --list

# Install a specific skill
npx add-skill pproenca/dot-skills --skill <skill-name>

# Install globally (across all projects)
npx add-skill pproenca/dot-skills --global
```

### Supported Agents

Skills are installed to agent-specific directories:

| Agent | Installation Path |
|-------|------------------|
| Claude Code | `.claude/skills/<name>/` |
| Cursor | `.cursor/skills/<name>/` |
| Codex | `.codex/skills/<name>/` |
| OpenCode | `.opencode/skill/<name>/` |
| Antigravity | `.agent/skills/<name>/` |

## Creating Skills

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on creating new skills.

### Quick Start

1. Copy the template: `cp -r skills/.template skills/my-skill`
2. Rename the template file: `mv skills/my-skill/SKILL.md.template skills/my-skill/SKILL.md`
3. Edit `SKILL.md` with your skill's frontmatter and instructions
4. Add scripts, references, or assets as needed
5. Test with `npx add-skill . --list`

## Skill Structure

```
skills/
├── my-skill/
│   ├── SKILL.md          # Required: Skill definition and instructions
│   ├── scripts/          # Optional: Executable scripts
│   ├── references/       # Optional: Additional documentation
│   └── assets/           # Optional: Static resources
├── .curated/             # Vetted, production-ready skills
├── .experimental/        # Work-in-progress skills
└── .template/            # Skill template (SKILL.md.template)
```

## License

MIT
