Agent Skills Collection

A collection of AI agent skills following the Agent Skills open format. These skills extend AI coding agents with specialized capabilities and domain knowledge.

Available Skills

Curated Skills

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

Experimental Skills

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

Installation

Install skills using Vercel's add-skill CLI:

# 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 for guidelines on creating new skills.

Quick Start

Copy the template: cp -r skills/.template skills/my-skill
Rename the template file: mv skills/my-skill/SKILL.md.template skills/my-skill/SKILL.md
Edit SKILL.md with your skill's frontmatter and instructions
Add scripts, references, or assets as needed
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

Name	swift-ui-best-practices
Description	SwiftUI best practices for building Apple-quality iOS app UIs. This skill should be used when writing, reviewing, or refactoring SwiftUI code to achieve native app polish matching Apple's Weather, Calendar, Photos, and Notes apps. Triggers on tasks involving SwiftUI views, iOS app development, HIG compliance, animations, accessibility, or performance optimization.

swift-ui-best-practices

SKILL.md