skills

A curated collection of agentic coding skills for Copilot, Claude, Codex, Cursor, Gemini, Warp, and similar tools.

Each skill lives in its own directory with a SKILL.md entry point and, when needed, supporting references, rules, assets, or sub-agents.

Install

Run the installer from the repo root:

./install.sh

The installer currently symlinks the repo-docs skill set into common skill directories for supported agents:

• repo-docs
• repo-docs-init
• repo-docs-audit

Supported install targets:

• ~/.agents/skills
• ~/.claude/skills
• ~/.codex/skills
• ~/.copilot/skills
• ~/.cursor/skills
• ~/.gemini/skills
• ~/.github/skills
• ~/.opencode/skills
• ~/.warp/skills

Use ./install.sh --force to replace existing symlinks that point somewhere else.

If you want to use other skills in this repo, symlink those directories manually into your agent's skills folder.

Skill Catalog

Docs And Planning

• repo-docs: Keep repo docs and source code in sync with a doc-first workflow centered on /docs.
• repo-docs-init: Bootstrap the repo-docs structure in an existing repository.
• repo-docs-audit: Audit /docs against implementation and fix drift.
• to-prd: Turn the current conversation into a PRD in docs/prd.
• to-issues: Break a plan, spec, or PRD into independently grabbable issues.
• ubiquitous-language: Extract and harden a DDD-style glossary for the project.

Research And Exploration

• qmd: Search markdown knowledge bases, notes, and documentation using QMD.
• find-skills: Help users discover skills that match the task they are trying to do.
• design-an-interface: Generate multiple interface designs for a module using parallel sub-agents.
• grill-me: Stress-test a plan or design by interviewing the user until weak spots are exposed.
• improve-codebase-architecture: Find architectural refactors that make a codebase deeper, cleaner, and more testable.

Workflow And Meta Skills

• write-a-skill: Create new skills with proper structure, references, and packaging.
• caveman: Switch into a terse, token-efficient response mode with multiple intensity levels.

Web And UI Review

• agent-browser: Automate browser interactions for testing, screenshots, form filling, and data extraction.
• web-design-guidelines: Review UI work for web design and accessibility guideline compliance.
• vercel-react-best-practices: Apply Vercel's React and Next.js performance guidance.

Apple Platform Skills

• macos-design-guidelines: Apply Apple's Human Interface Guidelines for macOS apps.
• swift-concurrency-expert: Review and remediate Swift 6.2+ concurrency issues.
• swiftui-expert-skill: Write or review SwiftUI using modern state, composition, and platform patterns.
• swiftui-liquid-glass: Implement or audit Liquid Glass usage for iOS 26+ SwiftUI features.
• swiftui-performance-audit: Audit SwiftUI performance and guide deeper profiling when needed.
• swiftui-pro: Comprehensive SwiftUI review for API quality, maintainability, and performance.
• swiftui-view-refactor: Refactor SwiftUI views toward smaller subviews, stable trees, and explicit dependencies.

Engineering Practice

• tdd: Drive implementation with a red-green-refactor workflow.