nitm-ai-dev-toolkit 3.0.15

package/README.md

@@ -0,0 +1,881 @@
+# AI-Assisted Development Toolkit
+
+A comprehensive template repository providing AI instruction files, prompts, and rules for AI-assisted development workflows. This toolkit helps teams establish consistent AI coding practices across projects.
+
+## Purpose
+
+This repository serves as a **template source** for AI development instructions that can be copied into your projects. It provides:
+
+- **Cursor IDE rules** (`.cursor/rules/`) for AI behavior configuration
+- **Cursor commands** (`.cursor/commands/`) for custom AI workflows
+- **GitHub Copilot instructions** (`.github/copilot-instructions.md`)
+- **GitHub prompts** (`.github/prompts/`) for reusable prompt templates
+- **AGENTS.md** files for AI agent context
+- **Skills recommendations** from [skills.sh](https://skills.sh/) for enhanced AI capabilities
+
+## Repository Structure
+
+```
+/
+├── src/
+│   ├── repo/           # Templates for single repositories
+│   │   ├── .cursor/    # Cursor IDE configuration
+│   │   │   ├── agents/ # Custom agent templates (subagents)
+│   │   │   ├── rules/  # IDE behavior rules
+│   │   │   ├── commands/ # Custom AI commands
+│   │   │   ├── skills/ # Additional skills (README placeholder)
+│   │   │   └── mcp.json # MCP server configuration template
+│   │   ├── .github/    # GitHub Copilot instructions
+│   │   │   ├── agents/ # Custom agent templates (subagents)
+│   │   │   ├── instructions/ # Context instructions
+│   │   │   ├── prompts/ # Reusable prompts
+│   │   │   └── skills/ # Additional skills (README placeholder)
+│   │   ├── .agents/    # Pre-installed universal skills
+│   │   │   ├── rules/  # Agent behavior rules (ponytail, etc.)
+│   │   │   └── skills/ # Bundled skills (TDD, debugging, etc.)
+│   │   ├── docs/       # Documentation structure templates
+│   │   ├── templates/  # Reusable document templates
+│   │   ├── AGENTS.md   # AI agent context template
+│   │   └── README.md   # Project README template
+│   │
+│   └── monorepo/       # Templates for monorepos
+│       ├── .cursor/    # Root-level Cursor config
+│       │   ├── agents/ # Custom agent templates (subagents)
+│       │   ├── rules/  # IDE behavior rules
+│       │   ├── commands/ # Custom AI commands
+│       │   ├── skills/ # Additional skills (README placeholder)
+│       │   └── mcp.json # MCP server configuration template
+│       ├── .github/    # Root-level GitHub config
+│       │   ├── agents/ # Custom agent templates (subagents)
+│       │   ├── instructions/ # Context instructions
+│       │   ├── prompts/ # Reusable prompts
+│       │   └── skills/ # Additional skills (README placeholder)
+│       ├── .agents/    # Pre-installed universal skills
+│       │   ├── rules/  # Agent behavior rules (ponytail, etc.)
+│       │   └── skills/ # Bundled skills (TDD, debugging, etc.)
+│       ├── apps/       # App-specific templates
+│       ├── packages/   # Package-specific templates
+│       ├── docs/       # Documentation structure templates
+│       ├── templates/  # Reusable document templates
+│       └── AGENTS.md   # Monorepo agent context
+│
+├── .cursor/            # This toolkit's own Cursor config
+├── .github/            # This toolkit's own GitHub config
+├── .opencode/          # This toolkit's own OpenCode config
+│   └── plugins/        # OpenCode plugins (ponytail mode manager, etc.)
+├── hooks/              # Claude Code / Copilot activation hooks (ponytail, etc.)
+└── AGENTS.md           # This toolkit's agent context
+```
+
+## Usage
+
+### For Single Repositories
+
+**Step 1: Copy the templates**
+
+```bash
+cp -r src/repo/.cursor /path/to/your/project/
+cp -r src/repo/.github /path/to/your/project/
+cp -r src/repo/.agents /path/to/your/project/
+cp src/repo/AGENTS.md /path/to/your/project/
+```
+
+The `.agents/skills/` folder contains pre-installed universal skills that are ready to use immediately (see [Bundled Universal Skills](#bundled-universal-skills)).
+
+**Step 2: Run the Bootstrap Command**
+
+Open your project in Cursor IDE or VS Code with GitHub Copilot, then run:
+
+- **Cursor IDE**: Use the `/bootstrap` command
+- **GitHub Copilot**: Use the `bootstrap.prompt.md` prompt (`/bootstrap`)
+
+The bootstrap process will:
+
+1. Analyze your project's structure, dependencies, and configuration files
+2. Infer template variables (framework, language, package manager, etc.)
+3. Prompt you for any values it couldn't detect
+4. Automatically update all `{{PLACEHOLDER}}` values in your AI instruction files
+
+**Step 3: Review and Customize**
+
+After bootstrapping, review the generated files and add any project-specific patterns to `AGENTS.md`.
+
+### For Monorepos
+
+**Step 1: Copy the templates**
+
+```bash
+cp -r src/monorepo/.cursor /path/to/your/project/
+cp -r src/monorepo/.github /path/to/your/project/
+cp -r src/monorepo/.agents /path/to/your/project/
+cp src/monorepo/AGENTS.md /path/to/your/project/
+# Optionally copy app/package templates
+cp -r src/monorepo/apps/app-template /path/to/your/project/apps/
+cp -r src/monorepo/packages/package-template /path/to/your/project/packages/
+```
+
+The `.agents/skills/` folder contains pre-installed universal skills that are ready to use immediately (see [Bundled Universal Skills](#bundled-universal-skills)).
+
+**Step 2: Run the Bootstrap Command**
+
+Open your project in Cursor IDE or VS Code with GitHub Copilot, then run:
+
+- **Cursor IDE**: Use the `/bootstrap` command
+- **GitHub Copilot**: Use the `bootstrap.prompt.md` prompt (`/bootstrap`)
+
+The bootstrap process will:
+
+1. Analyze your monorepo workspace, including all apps and packages
+2. Detect frameworks, ports, and deployment platforms for each app
+3. Infer package scopes and descriptions
+4. Prompt you for any missing information
+5. Create `AGENTS.md` files for each app with framework-specific patterns
+6. Update all `{{PLACEHOLDER}}` values throughout the monorepo
+
+**Step 3: Review and Customize**
+
+After bootstrapping:
+
+- Review root `AGENTS.md` for overall project context
+- Check each `apps/*/AGENTS.md` for app-specific patterns
+- Add any custom conventions or patterns unique to your project
+
+## CLI (npx)
+
+Scaffold AI agent config into any repo, then hand off to your AI agent to finish setup (replace `{{PLACEHOLDER}}`s, calibrate agent tools). The CLI scaffolds config for **all** supported harnesses (Claude Code, GitHub Copilot, Cursor, OpenCode); the `/bootstrap` command auto-detects your environment at runtime, so you normally don't need `--env`. `install` aborts if files already exist — use `--force` to overwrite, or `patch` to add only missing files.
+
+```bash
+# Scaffold AI config into the current repo (auto-detects repo vs monorepo)
+# Aborts if files already exist — use --force to overwrite, or `patch` to add missing
+npx nitm-ai-dev-toolkit install
+
+# Force a template type
+npx nitm-ai-dev-toolkit install --monorepo
+npx nitm-ai-dev-toolkit install --repo
+
+# Optional: scaffold only one harness (e.g. you only use Cursor)
+npx nitm-ai-dev-toolkit install --env cursor
+
+# Add only missing files (never overwrites existing ones) + re-emit the bootstrap handoff
+npx nitm-ai-dev-toolkit patch
+
+# Inspect the install: missing files and unresolved placeholders
+npx nitm-ai-dev-toolkit doctor
+
+# Upgrade to the latest published version
+npx nitm-ai-dev-toolkit upgrade
+
+# Scaffold the oh-my-opencode-slim starter (delegates to `npx nitm-opencode-starter install`)
+npx nitm-ai-dev-toolkit omo-slim-starter install
+```
+
+After `install`, run `/bootstrap` from whatever harness you're in — it auto-detects your environment. You can also read `.nitm/BOOTSTRAP.md` and ask your AI agent to run the bootstrap flow. Use `doctor` to verify the result.
+
+## Placeholder Reference
+
+Templates use `{{PLACEHOLDER}}` syntax for values you need to customize. The bootstrap command will automatically detect and fill most of these values.
+
+### Common Placeholders
+
+| Placeholder               | Description               | Example                                                               |
+| ------------------------- | ------------------------- | --------------------------------------------------------------------- |
+| `{{PROJECT_NAME}}`        | Your project name         | `my-awesome-app`                                                      |
+| `{{PROJECT_DESCRIPTION}}` | Brief project description | `A web app for...`                                                    |
+| `{{LANGUAGE}}`            | Primary language          | `TypeScript`, `PHP`, `C#`, `Python`, `Ruby`, `Go`, `Rust`, `Java`     |
+| `{{FRAMEWORK}}`           | Primary framework         | `Next.js`, `Laravel`, `Blazor`, `Django`, `Rails`, `Spring Boot`      |
+| `{{PACKAGE_MANAGER}}`     | Package manager           | `npm`, `composer`, `dotnet`, `pip`, `bundler`, `go`, `cargo`, `maven` |
+| `{{FILE_EXTENSION}}`      | File extension            | `ts`, `php`, `cs`, `py`, `rb`, `go`, `rs`, `java`                     |
+| `{{DEV_PORT}}`            | Development server port   | `3000`, `8000`, `5000`                                                |
+| `{{DEPLOY_PLATFORM}}`     | Deployment target         | `Vercel`, `AWS`, `Azure`, `Heroku`                                    |
+| `{{DATABASE}}`            | Database/ORM              | `Prisma`, `Eloquent`, `EF Core`, `SQLAlchemy`, `ActiveRecord`         |
+| `{{TEST_FRAMEWORK}}`      | Testing framework         | `Vitest`, `PHPUnit`, `xUnit`, `pytest`, `RSpec`, `JUnit`              |
+| `{{ISSUE_TRACKER}}`       | Issue tracking system     | `Jira`, `Linear`, `GitHub Issues`                                     |
+| `{{PM_URL}}`              | Issue tracker base URL    | `https://yourorg.atlassian.net`, `https://linear.app/myteam`          |
+| `{{PROJECT_KEY}}`         | Project/team key          | `PROJ`, `ENG`                                                         |
+| `{{PM_ISSUE_KEY}}`        | Issue key format          | `PROJ-###`, `#42`, `ENG-###`                                          |
+| `{{DEFAULT_BRANCH}}`      | Default git branch        | `main`, `master`                                                      |
+| `{{RUNTIME_VERSION}}`     | Runtime version           | `Node 20`, `PHP 8.3`, `.NET 8`, `Python 3.12`                         |
+| `{{REPO_URL}}`            | Repository URL            | `https://github.com/org/repo`                                         |
+| `{{SRC_DIR}}`             | Source directory          | `src`, `app`, `lib`                                                   |
+| `{{TEST_DIR}}`            | Test directory            | `tests`, `test`, `spec`                                               |
+| `{{STYLING}}`             | Styling solution          | `Tailwind`, `CSS Modules`, `SCSS`                                     |
+| `{{NODE_VERSION}}`        | Node.js version           | `20`, `22`                                                            |
+| `{{LICENSE_TYPE}}`        | License identifier        | `MIT`, `Apache-2.0`, `ISC`                                            |
+| `{{SRC_STRUCTURE}}`       | Source folder structure   | `components/`, `lib/`, `utils/`                                       |
+
+### Command Placeholders
+
+| Placeholder           | Description          | Example                                             |
+| --------------------- | -------------------- | --------------------------------------------------- |
+| `{{INSTALL_COMMAND}}` | Install dependencies | `npm install`, `composer install`, `dotnet restore` |
+| `{{DEV_COMMAND}}`     | Run dev server       | `npm run dev`, `php artisan serve`, `dotnet watch`  |
+| `{{BUILD_COMMAND}}`   | Build for production | `npm run build`, `dotnet publish`                   |
+| `{{TEST_COMMAND}}`    | Run tests            | `npm test`, `./vendor/bin/phpunit`, `dotnet test`   |
+| `{{LINT_COMMAND}}`    | Run linting          | `npm run lint`, `./vendor/bin/pint`                 |
+
+### Monorepo-Specific Placeholders
+
+| Placeholder                 | Description                | Example                                                 |
+| --------------------------- | -------------------------- | ------------------------------------------------------- |
+| `{{APP_NAME_1}}`            | First app name             | `web`, `frontend`                                       |
+| `{{APP_NAME_2}}`            | Second app name            | `api`, `server`                                         |
+| `{{APP_1_DESCRIPTION}}`     | First app description      | `Web frontend`                                          |
+| `{{APP_2_DESCRIPTION}}`     | Second app description     | `API server`                                            |
+| `{{APP_1_FRAMEWORK}}`       | First app framework        | `Next.js`, `Vue`                                        |
+| `{{APP_2_FRAMEWORK}}`       | Second app framework       | `Express`, `Hono`                                       |
+| `{{APP_1_DEV_PORT}}`        | First app dev port         | `3000`                                                  |
+| `{{APP_2_DEV_PORT}}`        | Second app dev port        | `8787`                                                  |
+| `{{PACKAGE_NAME_1}}`        | First package name         | `ui`, `shared`                                          |
+| `{{PACKAGE_NAME_2}}`        | Second package name        | `utils`, `types`                                        |
+| `{{PACKAGE_1_DESCRIPTION}}` | First package description  | `Shared UI components`                                  |
+| `{{PACKAGE_2_DESCRIPTION}}` | Second package description | `Utility functions`                                     |
+| `{{BUILD_SYSTEM}}`          | Monorepo build tool        | `Turborepo`, `Nx`, `MSBuild`, `Gradle`, `Cargo`         |
+| `{{MONOREPO_CONFIG}}`       | Config file name           | `turbo.json`, `nx.json`, `*.sln`, `settings.gradle.kts` |
+| `{{APP_DIR}}`               | Apps directory             | `apps`, `src`, `services`, `Modules`                    |
+| `{{PACKAGES_DIR}}`          | Packages directory         | `packages`, `libs`, `internal`, `pkg`                   |
+| `{{PACKAGE_SCOPE}}`         | Package scope/namespace    | `@my-org`, `MyCompany`, `my_package`                    |
+| `{{DOCS_APP}}`              | Docs app name              | `docs`, `documentation`, `storybook`                    |
+| `{{DOCS_CONTENT_DIR}}`      | Docs app content path      | `content/docs/`, `pages/`, `src/content/`               |
+| `{{APP_3}}`                 | Third app name             | `web`, `marketing`, `landing`                           |
+| `{{PROJECT_STRUCTURE}}`     | Full project structure     | (Generated tree diagram)                                |
+
+## Supported Ecosystems
+
+The bootstrap command supports the following language ecosystems:
+
+| Ecosystem                 | Config Files                         | Frameworks                                                | Monorepo Build Systems          |
+| ------------------------- | ------------------------------------ | --------------------------------------------------------- | ------------------------------- |
+| **JavaScript/TypeScript** | `package.json`, `tsconfig.json`      | Next.js, Nuxt, React, Vue, Angular, Express, Hono, NestJS | Turborepo, Nx, Lerna, Yarn/pnpm |
+| **PHP**                   | `composer.json`, `artisan`           | Laravel, Symfony, CodeIgniter, Slim                       | Laravel Modules, Symfony Flex   |
+| **.NET (C#/F#)**          | `*.csproj`, `*.sln`                  | Blazor, ASP.NET Core, MAUI, WPF                           | MSBuild, dotnet CLI             |
+| **Python**                | `pyproject.toml`, `requirements.txt` | Django, Flask, FastAPI, Starlette                         | uv, Poetry, Hatch, PDM          |
+| **Ruby**                  | `Gemfile`, `*.gemspec`               | Rails, Sinatra, Hanami                                    | Packwerk (Shopify)              |
+| **Go**                    | `go.mod`, `go.work`                  | Gin, Echo, Fiber, Chi                                     | Go Workspaces                   |
+| **Rust**                  | `Cargo.toml`                         | Actix, Axum, Rocket, Warp                                 | Cargo Workspaces                |
+| **Java/Kotlin**           | `pom.xml`, `build.gradle.kts`        | Spring Boot, Quarkus, Micronaut                           | Gradle multi-project, Maven     |
+
+## File Descriptions
+
+### AGENTS.md
+
+The primary context file for AI agents. Contains:
+
+- Project overview and tech stack
+- Directory structure
+- Coding standards and patterns
+- API patterns and examples
+- Testing guidelines
+
+### .cursor/rules/\*.mdc
+
+Cursor IDE behavior rules:
+
+- `agent-conduct.mdc` - Agent behavior and conduct guidelines
+- `coding-standards.mdc` - Language and framework standards
+- `project-context.mdc` - Project documentation requirements
+- `version-control.mdc` - Git and commit conventions
+- `what-to-avoid.mdc` - Anti-patterns and deprecated practices
+- `api-server.mdc` - API server patterns
+- `component-structure.mdc` - Vue Composition API patterns
+- `core-libraries.mdc` - Core library usage
+- `environment-tooling.mdc` - Environment and tooling configuration
+- `logging.mdc` - Structured logging standards
+- `logging-comments.mdc` - Logging and code comment conventions
+- `prisma-migrations.mdc` - Prisma database migrations
+- `server-client-separation.mdc` - Server/client code separation
+- `subagent-workflow.mdc` - Subagent orchestration patterns
+- `testing-quality.mdc` - Testing standards and quality
+- `ui-accessibility.mdc` - UI and accessibility guidelines
+
+### .cursor/commands/\*.md
+
+Custom Cursor commands for workflows:
+
+- `bootstrap.md` - **Start here!** Analyze project and customize templates
+- `specify.md` - Create feature specifications
+- `plan.md` - Generate implementation plans
+- `implement.md` - Execute implementation tasks
+- `implement-feature.md` - Feature implementation workflow
+- `implement-fixes.md` - Bug fix implementation workflow
+- `review.md` - Code review workflow
+- `review-pr.md` - Pull request review workflow
+- `commit-push.md` - Git commit and push workflow
+- `constitution.md` - Project constitution and principles
+- `tasks.md` - Task management workflow
+- `assign-tasks.md` - Task assignment workflow
+- `create-skill.md` - Create custom AI skills
+- `playwright-test.md` - Playwright test generation
+- `release-notes.md` - Release notes generation
+
+### .github/prompts/\*.prompt.md
+
+Reusable prompts for GitHub Copilot:
+
+- `bootstrap.prompt.md` - **Start here!** Analyze project and customize templates
+- `commit-push.prompt.md` - Conventional commit workflow
+- `review.prompt.md` - Code review checklist
+- `review-pr.prompt.md` - Pull request review
+- `review-staged.prompt.md` - Review staged changes
+- `implement-feature.prompt.md` - Feature implementation
+- `implement-fixes.prompt.md` - Bug fix implementation
+- `specify.prompt.md` - Feature specification
+- `plan.prompt.md` - Implementation planning
+- `tasks.prompt.md` - Task management
+- `assign-tasks.prompt.md` - Task assignment workflow
+- `create-skill.prompt.md` - Create custom AI skills
+- `playwright-test.prompt.md` - Playwright test generation
+- `release-notes.prompt.md` - Release notes generation
+
+### .github/instructions/\*.instructions.md
+
+GitHub Copilot instruction files:
+
+- `project-context.instructions.md` - Architecture overview
+- `patterns.instructions.md` - Coding patterns
+- `workflows.instructions.md` - Development workflows
+- `documentation.instructions.md` - Documentation standards for features and fixes
+- `agent-conduct.instructions.md` - Agent behavior and conduct guidelines
+- `coding-standards.instructions.md` - Language and framework coding standards
+- `deployment.instructions.md` - Deployment patterns and configuration
+- `logging.instructions.md` - Structured logging standards
+- `subagent-workflow.instructions.md` - Subagent orchestration patterns
+- `testing.instructions.md` - Testing standards and quality
+
+### .github/agents/\*.agent.md & .cursor/agents/\*.agent.md
+
+Custom agent templates for subagent orchestration (identical files in both directories):
+
+- `feature-builder.agent.md` - **Coordinator** — Orchestrates end-to-end feature development
+- `tdd.agent.md` - **Coordinator** — Test-driven development with red-green-refactor cycle
+- `planner.agent.md` - **Worker** — Breaks features into implementation tasks
+- `implementer.agent.md` - **Worker** — Writes production code with TDD
+- `reviewer.agent.md` - **Worker** — Multi-perspective code review
+- `researcher.agent.md` - **Worker** — Read-only codebase analysis
+- `red.agent.md` - **Worker** — Writes failing tests (TDD red phase)
+- `green.agent.md` - **Worker** — Writes minimal code to pass tests (TDD green phase)
+- `refactor.agent.md` - **Worker** — Improves code quality while keeping tests green
+- `admin-portal.agent.md` - **Domain** — Admin portals with RBAC, dashboards, and reporting
+- `api-specialist.agent.md` - **Domain** — API architecture, documentation, and developer experience
+- `backend-architect.agent.md` - **Domain** — APIs, databases, and server-side architecture
+- `documenter.agent.md` - **Domain** — Codebase analysis and comprehensive documentation
+- `frontend-developer.agent.md` - **Domain** — User interfaces, components, and frontend performance
+
+> See [Custom Agents & Subagents](#custom-agents--subagents) for detailed usage.
+
+### docs/\* (Documentation Structure)
+
+Documentation folders for tracking features and fixes:
+
+- `docs/features/` - Feature documentation with specs and plans
+- `docs/fixes/` - Fix documentation with monthly logs and complex fix folders
+- `docs/architecture/` - Architecture Decision Records (ADRs)
+- `docs/api/` - API specifications
+- `templates/` - Reusable documentation templates
+
+**Monorepo Note**: In monorepos, app-specific docs live in `apps/{app}/docs/` and root `docs/` is only for monorepo-wide concerns. See [monorepo documentation.instructions.md](src/monorepo/.github/instructions/documentation.instructions.md) for details.
+
+#### Documentation Best Practices
+
+**Feature Documentation:**
+
+- Create folder: `docs/features/{{ISSUE_ID}}-FEATURE-NAME/`
+- Include `spec.md` (functional specification) and `plan.md` (implementation plan)
+- Use `/spec` and `/plan` commands for automatic generation
+
+**Fix Documentation:**
+
+- **Simple fixes**: Add to monthly log `docs/fixes/{YYYY-MM}.md`
+- **Complex fixes**: Create folder `docs/fixes/{{ISSUE_ID}}-FIX-NAME/` with spec and plan
+- Use [Keep a Changelog](https://keepachangelog.com/) format
+
+**Decision Tree**: Is fix complex (multi-file, architectural)? → Folder. Otherwise → Monthly log.
+
+See [documentation.instructions.md](src/repo/.github/instructions/documentation.instructions.md) for comprehensive guidelines.
+
+## Custom Agents & Subagents
+
+This toolkit includes **14 custom agent templates** that enable subagent-based workflows — a coordinator agent delegates subtasks to specialized worker agents, each with isolated context and specific tools.
+
+Subagents are supported by both **VS Code (GitHub Copilot)** and **Cursor IDE**. Agent files are placed in:
+
+- `.github/agents/` — GitHub Copilot custom agents
+- `.cursor/agents/` — Cursor custom agents
+
+Both directories contain identical agent files. The toolkit ships both so agents work regardless of your IDE.
+
+> **Official Docs:** [VS Code Subagents](https://code.visualstudio.com/docs/copilot/agents/subagents) · [Cursor Subagents](https://cursor.com/docs/subagents)
+
+### How Subagents Work
+
+Subagents provide **context isolation** — each subagent runs independently, sees only what the coordinator passes, and returns a focused result. This prevents context pollution and keeps each agent focused.
+
+```
+┌─────────────────────────────────┐
+│      Feature Builder            │  ← Coordinator agent
+│      (orchestrates workflow)    │
+├─────────┬───────────┬───────────┤
+│         │           │           │
+▼         ▼           ▼           ▼
+Planner  Implementer  Reviewer   Researcher
+(plan)   (code)       (review)   (read-only)
+         │
+    ┌────┴────┐
+    ▼         ▼
+  Tests    Production
+  first    code
+```
+
+The coordinator decides when to delegate. You don't need to manually invoke subagents — just describe the task:
+
+- _"Use the Feature Builder to implement user authentication"_
+- _"Run the TDD agent for this API endpoint"_
+- _"Use a subagent to research the codebase authentication patterns"_
+
+### Included Agents
+
+| Agent                  | Type        | Tools                        | `user-invocable` | Purpose                                       |
+| ---------------------- | ----------- | ---------------------------- | ---------------- | --------------------------------------------- |
+| **Feature Builder**    | Coordinator | agent, edit, search, read    | `true`           | Orchestrates end-to-end feature development   |
+| **TDD**                | Coordinator | agent, edit, search, read    | `true`           | Red-green-refactor cycle coordination         |
+| **Planner**            | Worker      | read, search, edit, terminal | `false`          | Break down features into implementation tasks |
+| **Implementer**        | Worker      | read, search, edit, terminal | `false`          | Write production code following TDD           |
+| **Reviewer**           | Worker      | read, search, terminal       | `false`          | Multi-perspective code review                 |
+| **Researcher**         | Worker      | read, search                 | `true`           | Read-only codebase analysis                   |
+| **Red**                | Worker      | read, search, edit, terminal | `false`          | Write failing tests (TDD red phase)           |
+| **Green**              | Worker      | read, search, edit, terminal | `false`          | Write minimal code to pass tests (TDD green)  |
+| **Refactor**           | Worker      | read, search, edit, terminal | `false`          | Improve code quality, keep tests green        |
+| **Admin Portal**       | Domain      | read, search, edit, terminal | `true`           | Admin portals with RBAC and dashboards        |
+| **API Specialist**     | Domain      | read, search, edit, terminal | `true`           | API architecture, docs, and DX                |
+| **Backend Architect**  | Domain      | read, search, edit, terminal | `true`           | APIs, databases, and server architecture      |
+| **Documenter**         | Domain      | read, search, edit, terminal | `true`           | Codebase analysis and documentation           |
+| **Frontend Developer** | Domain      | read, search, edit, terminal | `true`           | UI components and frontend performance        |
+
+**Coordinator agents** (Feature Builder, TDD) appear in the agents dropdown and orchestrate worker agents.
+**Worker agents** (`user-invocable: false`) are only accessible as subagents — they don't appear in the dropdown.
+**Domain agents** (Admin Portal, API Specialist, Backend Architect, Documenter, Frontend Developer) are user-invocable specialists for specific development domains.
+**Researcher** is both user-invocable and usable as a subagent.
+
+### Orchestration Patterns
+
+#### Coordinator → Worker (Feature Builder)
+
+The Feature Builder agent manages the full lifecycle:
+
+1. **Research** → Researcher subagent analyzes codebase patterns
+2. **Plan** → Planner subagent creates implementation tasks
+3. **Implement** → Implementer subagent writes code (per task)
+4. **Review** → Reviewer subagent checks quality (per task)
+5. **Iterate** → Implementer fixes review issues
+6. **Verify** → Final test run
+
+#### TDD Red-Green-Refactor
+
+The TDD agent coordinates the classic cycle using the `agents` frontmatter to restrict which subagents are available:
+
+```yaml
+---
+agents: ["Red", "Green", "Refactor"]
+---
+```
+
+1. **Red** → Red subagent writes failing tests
+2. **Green** → Green subagent writes minimal code to pass
+3. **Refactor** → Refactor subagent improves quality
+
+#### Multi-Perspective Review
+
+You can prompt for parallel review:
+
+> _"Review this PR through multiple perspectives simultaneously: correctness, security, code quality, and architecture."_
+
+The main agent will dispatch independent subagents for each perspective, then synthesize findings.
+
+### Agent Frontmatter Reference
+
+Agent files use YAML frontmatter to configure behavior:
+
+```yaml
+---
+name: MyAgent # Agent name (required)
+description: "When to use..." # Discovery description (required)
+tools: ["read", "search", "edit"] # Allowed tools
+agents: ["Worker1", "Worker2"] # Restrict which subagents can be used
+user-invocable: true # Show in agents dropdown (default: true)
+disable-model-invocation: false # Prevent use as subagent (default: false)
+model: ["Claude Sonnet 4", "GPT-4o"] # Preferred models (optional)
+---
+```
+
+| Property                   | Default | Description                                         |
+| -------------------------- | ------- | --------------------------------------------------- |
+| `name`                     | —       | Agent name used in dropdown and subagent invocation |
+| `description`              | —       | How the agent is discovered and when it's invoked   |
+| `tools`                    | all     | Restrict available tools per agent                  |
+| `agents`                   | `*`     | Restrict which subagents this agent can invoke      |
+| `user-invocable`           | `true`  | Whether it shows in the agents dropdown             |
+| `disable-model-invocation` | `false` | Whether other agents can invoke this as a subagent  |
+| `model`                    | —       | Preferred model(s) for the agent                    |
+
+### Creating Custom Agents
+
+To add project-specific agents:
+
+1. Create a `.agent.md` file in `.github/agents/` and/or `.cursor/agents/`
+2. Add YAML frontmatter with `name`, `description`, and `tools`
+3. Write instructions in the markdown body
+4. For worker-only agents, set `user-invocable: false`
+5. For coordinator agents, list allowed subagents in `agents`
+
+**Example — Documentation Writer agent:**
+
+```markdown
+---
+name: Doc Writer
+description: "Write and update project documentation. Create READMEs, API docs, and changelogs."
+tools: ["read", "search", "edit"]
+user-invocable: true
+---
+
+# Documentation Writer
+
+Write clear, accurate project documentation following the project's conventions.
+
+## Process
+
+1. Read existing documentation and code
+2. Identify what needs documenting
+3. Write documentation following project patterns
+4. Cross-reference with code to ensure accuracy
+```
+
+### Nested Subagents
+
+By default, subagents cannot spawn further subagents (prevents infinite recursion). To enable nested delegation for divide-and-conquer patterns:
+
+- **VS Code**: Enable `chat.subagents.allowInvocationsFromSubagents` in settings
+- **Cursor**: Supported by default with a maximum nesting depth
+
+### Integration with Skills
+
+The bundled skills complement custom agents:
+
+- **`subagent-driven-development`** — Full workflow for executing plans via subagent dispatch with two-stage review
+- **`dispatching-parallel-agents`** — Patterns for parallel agent coordination on independent problems
+- **`writing-plans`** — Creating the plans that Feature Builder and TDD agents execute
+- **`test-driven-development`** — The TDD methodology that Red/Green/Refactor agents implement
+
+## AI Agent Skills
+
+Enhance your AI agents with specialized capabilities using the **Agent Skills** open format. Skills are folders of instructions, scripts, and resources that agents can discover and use to perform tasks more accurately and efficiently.
+
+### Skills Resources
+
+| Resource                                      | Description                                                                               |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| [agentskills.io](https://agentskills.io/home) | Official specification, documentation, and integration guides for the Agent Skills format |
+| [skills.sh](https://skills.sh/)               | Community skills directory with leaderboard and one-command installation                  |
+
+### How Skills Work
+
+Skills use **progressive disclosure** to manage context efficiently:
+
+1. **Discovery**: Agents load only the name and description of each skill
+2. **Activation**: When a task matches a skill's description, the agent reads full instructions
+3. **Execution**: The agent follows instructions, loading referenced files or code as needed
+
+### Skill Structure
+
+At its core, a skill is a folder containing a `SKILL.md` file:
+
+```
+my-skill/
+├── SKILL.md        # Required: instructions + metadata
+├── scripts/        # Optional: executable code
+├── references/     # Optional: documentation
+└── assets/         # Optional: templates, resources
+```
+
+### Installing Skills
+
+Install skills from [skills.sh](https://skills.sh/) using the `-a` or `--agent` flag to specify your AI agent:
+
+```bash
+# For a single agent
+npx -y skills add -a cursor <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For multiple agents (use multiple -a flags)
+npx -y skills add -a cursor -a github-copilot <owner/repo> --skill '*' --agent github-copilot cursor
+```
+
+#### Agent Detection
+
+The skills CLI **automatically detects** which agents you have installed when you run any command. If you don't specify the `-a` flag, you'll be prompted to select from your detected agents.
+
+Supported agents include:
+
+- **Cursor, GitHub Copilot, Windsurf, Cline, Continue, Aider, Zed, Roo Code, and 35+ more**
+- See [full list of supported agents](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)
+
+#### Agent-Specific Installation Examples
+
+```bash
+# For GitHub Copilot only
+npx -y skills add -a github-copilot <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For Cursor only
+npx -y skills add -a cursor <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For Windsurf only
+npx -y skills add -a windsurf <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For Cline only
+npx -y skills add -a cline <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For both Cursor and GitHub Copilot
+npx -y skills add -a cursor -a github-copilot <owner/repo> --skill '*' --agent github-copilot cursor
+```
+
+**Important:** Always specify the agent(s) explicitly using `-a <agent-name>` to install only for the agents you actively use. You can specify multiple agents using multiple `-a` flags. This prevents creating unnecessary configurations for unused agents.
+
+Skills are installed to `{.cursor|.agents|.github}/skills/` and automatically available to your selected AI agent(s).
+
+### Bundled Universal Skills
+
+This toolkit includes **32 pre-installed universal skills** in the `.agents/skills/` folder. These skills are copied automatically when you set up your project and require **no additional installation**.
+
+| Skill                              | Description                                                                                          |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| **test-driven-development**        | TDD practices with red-green-refactor workflow. Write failing test first, then minimal code to pass. |
+| **systematic-debugging**           | Structured debugging methodology. Find root cause before attempting fixes—no guessing.               |
+| **verification-before-completion** | Quality checks before claiming work is done. Evidence before assertions, always.                     |
+| **writing-plans**                  | Creating clear implementation plans before coding.                                                   |
+| **executing-plans**                | Following through on implementation plans systematically.                                            |
+| **requesting-code-review**         | Best practices for requesting code reviews from teammates.                                           |
+| **receiving-code-review**          | Responding constructively to review feedback.                                                        |
+| **brainstorming**                  | Structured ideation and problem-solving sessions.                                                    |
+| **writing-skills**                 | Creating effective SKILL.md files for custom skills.                                                 |
+| **using-superpowers**              | Meta-skill for leveraging the full skill system.                                                     |
+| **using-git-worktrees**            | Git worktree workflows for parallel development.                                                     |
+| **dispatching-parallel-agents**    | Coordinating multiple AI agents on related tasks.                                                    |
+| **subagent-driven-development**    | Breaking complex tasks into subagent-manageable chunks.                                              |
+| **finishing-a-development-branch** | Completing and merging development branches cleanly.                                                 |
+| **logging**                        | Structured logging standards, log levels, and observability patterns.                                |
+| **project-documentation**          | README files, code comments, ADRs, and changelog best practices.                                     |
+| **ponytail**                       | Forces the laziest solution that actually works — YAGNI, stdlib, native, one-line, minimum.          |
+| **ponytail-audit**                 | Whole-repo audit for over-engineering. Scans entire codebase for what to delete, simplify, replace.  |
+| **ponytail-debt**                  | Harvests `ponytail:` comments into a tracked debt ledger so shortcuts don't rot into neglect.        |
+| **ponytail-gain**                  | Displays ponytail's benchmarked impact scoreboard: less code, less cost, more speed.                 |
+| **ponytail-help**                  | Quick-reference card for all ponytail modes, skills, commands, and deactivation.                     |
+| **ponytail-review**                | Code review focused exclusively on over-engineering: finds what to delete in a diff.                 |
+| **orient-to-recent-work**          | Build a compact mental model of recent project activity (CHANGELOG, recent commits) before any non-trivial task. Auto-loaded at session start. |
+| **acli**                           | Atlassian CLI wrapper for Jira and Confluence operations from the terminal.                                               |
+| **code-simplifier**                | Simplifies code for clarity without changing behavior. Use for readability and maintainability.                            |
+| **debugger**                       | Structured debugging methodology with systematic root cause analysis.                                                      |
+| **gh-cli**                         | GitHub CLI reference for issues, PRs, repos, and workflow management.                                                     |
+| **issue-tracker**                  | Issue tracker integration patterns for Jira, Linear, and GitHub Issues.                                                   |
+| **linear-cli**                     | Linear CLI reference for issue management and project tracking.                                                           |
+| **security-reviewer**              | Security-focused code review patterns for finding vulnerabilities.                                                        |
+| **bkt-cli**                        | Bitbucket CLI (`bkt`) command reference for repo and monorepo templates.                                                  |
+| **glab-cli**                       | GitLab CLI (`glab`) command reference for repo and monorepo templates.                                                    |
+
+**These skills are ready to use immediately after copying the templates.** No `npx -y skills add -a <agent> <owner/repo> --skill '*' --agent github-copilot cursor` commands needed.
+
+The **ponytail** skill bundle is an integrated optional skill set from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) that adds YAGNI/stdlib/native/one-line/minimum discipline to your AI agents. It includes 6 skills, 6 commands, an OpenCode plugin, 7 activation hooks, and ambient agent rules — all pre-configured and ready to use.
+
+### Additional Recommended Skills
+
+Beyond the bundled skills, these additional skills complement this toolkit for specific use cases:
+
+**Note:** All install commands in the tables below should include the `-a <agent>` flag to specify your AI agent. For example:
+
+- `npx -y skills add -a github-copilot obra/superpowers --skill '*' --agent github-copilot cursor` (for GitHub Copilot only)
+- `npx -y skills add -a cursor obra/superpowers --skill '*' --agent github-copilot cursor` (for Cursor only)
+- `npx -y skills add -a cursor -a github-copilot obra/superpowers --skill '*' --agent github-copilot cursor` (for both Cursor and GitHub Copilot)
+
+**Tip:** If you omit the `-a` flag, the CLI will automatically detect your installed agents and prompt you to choose.
+
+#### Development Workflow Skills (External)
+
+If you want the original `obra/superpowers` skills (which the bundled skills are derived from), or additional workflow skills:
+
+| Skill                      | Install Command                                                                | Description                                  |
+| -------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------- |
+| **Full Superpowers Suite** | `npx -y skills add obra/superpowers --skill '*' --agent github-copilot cursor` | All workflow skills from the original source |
+
+#### Security & Quality Skills
+
+| Skill                      | Install Command                                                                              | Description                            |
+| -------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------- |
+| **Semgrep**                | `npx -y skills add trailofbits/skills --skill '*' --agent github-copilot cursor`             | Static analysis patterns               |
+| **Property-Based Testing** | `npx -y skills add trailofbits/skills --skill '*' --agent github-copilot cursor`             | Testing with property-based approaches |
+| **Code Review**            | `npx -y skills add skillcreatorai/Ai-Agent-Skills --skill '*' --agent github-copilot cursor` | Comprehensive code review guidance     |
+| **Logging Best Practices** | `npx -y skills add boristane/agent-skills --skill '*' --agent github-copilot cursor`         | Structured logging patterns            |
+
+#### Frontend Skills
+
+| Skill                           | Install Command                                                                        | Description                     |
+| ------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------- |
+| **Vercel React Best Practices** | `npx -y skills add vercel-labs/agent-skills --skill '*' --agent github-copilot cursor` | React patterns and optimization |
+| **Web Design Guidelines**       | `npx -y skills add vercel-labs/agent-skills --skill '*' --agent github-copilot cursor` | UI/UX design principles         |
+| **Frontend Design**             | `npx -y skills add anthropics/skills --skill '*' --agent github-copilot cursor`        | General frontend patterns       |
+| **TailwindCSS Setup**           | `npx -y skills add expo/skills --skill '*' --agent github-copilot cursor`              | Tailwind configuration          |
+
+#### Framework-Specific Skills
+
+| Skill           | Install Command                                                                                   | Description               |
+| --------------- | ------------------------------------------------------------------------------------------------- | ------------------------- |
+| **Vue**         | `npx -y skills add onmax/nuxt-skills --skill '*' --agent github-copilot cursor`                   | Vue.js best practices     |
+| **Nuxt**        | `npx -y skills add onmax/nuxt-skills --skill '*' --agent github-copilot cursor`                   | Nuxt framework patterns   |
+| **Nuxt UI**     | `npx -y skills add onmax/nuxt-skills --skill '*' --agent github-copilot cursor`                   | Nuxt UI component library |
+| **Better Auth** | `npx -y skills add better-auth/skills --skill '*' --agent github-copilot cursor`                  | Authentication patterns   |
+| **Expo**        | `npx -y skills add expo/skills --skill '*' --agent github-copilot cursor`                         | React Native with Expo    |
+| **NestJS**      | `npx -y skills add Kadajett/agent-nestjs-skills --skill '*' --agent github-copilot cursor`        | NestJS backend patterns   |
+| **Elysia.js**   | `npx -y skills add elysiajs/skills --skill '*' --agent github-copilot cursor`                     | Elysia.js API patterns    |
+| **Three.js**    | `npx -y skills add CloudAI-X/threejs-skills --skill '*' --agent github-copilot cursor`            | Three.js 3D graphics      |
+| **Remotion**    | `npx -y skills add remotion-dev/skills --skill '*' --agent github-copilot cursor`                 | Remotion video creation   |
+| **Convex**      | `npx -y skills add waynesutton/convexskills --skill '*' --agent github-copilot cursor`            | Convex backend patterns   |
+| **TanStack**    | `npx -y skills add jezweb/claude-skills --skill '*' --agent github-copilot cursor`                | TanStack Query patterns   |
+| **SwiftUI**     | `npx -y skills add Dimillian/Skills --skill '*' --agent github-copilot cursor`                    | SwiftUI iOS patterns      |
+| **Obsidian**    | `npx -y skills add kepano/obsidian-skills --skill '*' --agent github-copilot cursor`              | Obsidian note-taking      |
+| **shadcn/ui**   | `npx -y skills add giuseppe-trisciuoglio/developer-kit --skill '*' --agent github-copilot cursor` | shadcn/ui components      |
+| **Stripe**      | `npx -y skills add anthropics/claude-plugins-official --skill '*' --agent github-copilot cursor`  | Stripe integration        |
+
+#### Language-Specific Skills
+
+| Language/Framework | Install Command                                                                        | Included Skills                   |
+| ------------------ | -------------------------------------------------------------------------------------- | --------------------------------- |
+| **PHP**            | `npx -y skills add vapvarun/claude-backup --skill "php"`                               | PHP best practices                |
+| **Laravel**        | `npx -y skills add vapvarun/claude-backup --skill "laravel"`                           | Laravel patterns                  |
+| **Python**         | `npx -y skills add siviter-xyz/dot-agent --skill "python"`                             | Python best practices             |
+| **Django**         | `npx -y skills add vintasoftware/django-ai-plugins --skill "django-expert"`            | Django patterns                   |
+| **Next.js**        | `npx -y skills add sickn33/antigravity-awesome-skills --skill "nextjs-best-practices"` | Next.js best practices            |
+| **React**          | `npx -y skills add vercel-labs/agent-skills --skill "vercel-react-best-practices"`     | React + Vercel patterns           |
+| **Vue**            | `npx -y skills add onmax/nuxt-skills --skill "vue"`                                    | Vue.js best practices             |
+| **Nuxt**           | `npx -y skills add onmax/nuxt-skills --skill "nuxt"`                                   | Nuxt patterns                     |
+| **Expo**           | `npx -y skills add expo/skills --skill '*' --agent github-copilot cursor`              | Expo/React Native                 |
+| **TypeScript**     | `npx -y skills add pproenca/dot-skills --skill '*' --agent github-copilot cursor`      | TypeScript best practices         |
+| **Advanced Types** | `npx -y skills add wshobson/agents --skill '*' --agent github-copilot cursor`          | TypeScript advanced type patterns |
+
+**Note:** For frameworks without dedicated skills, use `npx -y skills add -a <agent> anthropics/skills --skill '*' --agent github-copilot cursor` which includes `skill-creator` to help you create custom skills. Remember to replace `<agent>` with your AI agent name (e.g., `copilot`, `cursor`, `windsurf`, `cline`).
+
+#### Documentation & Writing Skills
+
+| Skill                             | Install Command                                                                        | Description                 |
+| --------------------------------- | -------------------------------------------------------------------------------------- | --------------------------- |
+| **Crafting Effective READMEs**    | `npx -y skills add softaworks/agent-toolkit --skill '*' --agent github-copilot cursor` | README writing guidance     |
+| **Writing Clearly and Concisely** | `npx -y skills add softaworks/agent-toolkit --skill '*' --agent github-copilot cursor` | Clear technical writing     |
+| **Doc Coauthoring**               | `npx -y skills add anthropics/skills --skill '*' --agent github-copilot cursor`        | Collaborative documentation |
+
+### Adding Skills to Your Project
+
+After bootstrapping your project with this toolkit:
+
+1. **Identify your tech stack** - Review your framework and tooling
+2. **Install relevant skills** - Add skills that match your technologies using `-a <agent>` flags
+3. **Add custom skills** - Create project-specific skills as needed
+
+**Example for a Nuxt + Hono monorepo:**
+
+```bash
+# Note: Development workflow skills (TDD, debugging, planning, etc.)
+# are already bundled in .agents/skills/ - no installation needed!
+
+# For Cursor only
+npx -y skills add -a cursor onmax/nuxt-skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor vercel-labs/agent-skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor better-auth/skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor trailofbits/skills --skill '*' --agent github-copilot cursor
+
+# Or, for multiple agents (e.g., Cursor + GitHub Copilot)
+npx -y skills add -a cursor -a github-copilot onmax/nuxt-skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor -a github-copilot vercel-labs/agent-skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor -a github-copilot better-auth/skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor -a github-copilot trailofbits/skills --skill '*' --agent github-copilot cursor
+```
+
+### Creating Custom Skills
+
+You can create project-specific skills following:
+
+- **[Official Specification](https://agentskills.io/specification)** - Complete format specification for SKILL.md files
+- **[Authoring Best Practices](https://agentskills.io/what-are-skills)** - Guidelines for writing effective skills
+- **[Skill Creator on skills.sh](https://skills.sh/)** - Community examples and templates
+
+A minimal `SKILL.md` requires only name and description in YAML frontmatter:
+
+```markdown
+---
+name: my-custom-skill
+description: When to use this skill and what it does.
+---
+
+# My Custom Skill
+
+## When to use this skill
+
+Use this skill when the user needs to...
+
+## Instructions
+
+1. Step one...
+2. Step two...
+```
+
+Custom skills are useful for:
+
+- Organization-specific coding standards
+- Internal library documentation
+- Domain-specific patterns
+- Team workflow procedures
+
+### Skill Directory Structure
+
+After copying templates and installing additional skills, your project will have:
+
+```
+.agents/                  # Bundled universal skills (from this toolkit)
+└── skills/
+    ├── test-driven-development/
+    │   └── SKILL.md
+    ├── systematic-debugging/
+    │   └── SKILL.md
+    ├── verification-before-completion/
+    │   └── SKILL.md
+    └── ... (32 skills total)
+
+.cursor/                  # or .github/ for GitHub Copilot
+├── rules/                # IDE behavior rules (from this toolkit)
+├── commands/             # Custom commands (from this toolkit)
+└── skills/               # Additional skills from skills.sh
+    ├── nuxt-skills/      # From onmax/nuxt-skills
+    │   └── SKILL.md
+    ├── agent-skills/     # From vercel-labs/agent-skills
+    │   └── SKILL.md
+    └── {skill-name}/     # Each installed skill gets its own folder
+        └── SKILL.md
+```
+
+**Skill Locations:**
+
+| Location          | Contents                                                   | Source                                                                                              |
+| ----------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `.agents/skills/` | Universal workflow skills (TDD, debugging, planning, etc.) | Bundled with this toolkit                                                                           |
+| `.cursor/skills/` | Framework/language-specific skills                         | Installed via `npx -y skills add -a <agent> <owner/repo> --skill '*' --agent github-copilot cursor` |
+| `.github/skills/` | Alternative location for GitHub Copilot                    | Installed via `npx -y skills add -a <agent> <owner/repo> --skill '*' --agent github-copilot cursor` |
+
+**Note:** Skills installed via `npx -y skills add -a <agent> <owner/repo> --skill '*' --agent github-copilot cursor` use the skill name as the folder name (not org/repo path). For example, `npx -y skills add -a cursor obra/superpowers --skill '*' --agent github-copilot cursor` installs to `.cursor/skills/superpowers/`.
+
+**Recommendation:** Only install skills for agents you have installed and actively use. Symlinking to all known agents creates unnecessary configuration files and can clutter your project.
+
+**Note:** Skills complement the templates in this toolkit. The templates provide project structure and conventions, while skills provide procedural knowledge for specific technologies.
+
+## Contributing
+
+1. Fork this repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details.