create-subagent

Creates custom Cursor subagents with YAML frontmatter and system prompts.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill create-subagent-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/kkkaoru/dotfiles/tree/main/.cursor/skills-cursor/create-subagent
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill create-subagent-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up specialized AI assistants for recurring tasks like code review or debugging requires knowing the correct file format, directory locations, and frontmatter conventions. This Skill guides the creation of custom Cursor subagents so delegation works reliably. ## Core Features & Use Cases - Subagent File Creation: Generates .md files with valid YAML frontmatter (name, description) and a markdown system prompt body. - Scope Selection: Places subagents in .cursor/agents/ for project-level sharing or ~/.cursor/agents/ for personal cross-project use, with correct priority handling. - Ready-Made Templates: Provides complete examples for a code reviewer, debugger, and data scientist subagent. - Use Case: After repeatedly asking the AI to review code, create a code-reviewer subagent with a proactive description so the AI delegates reviews automatically after every code change. ## Quick Start Create a code-reviewer subagent for this project that proactively reviews code for quality, security, and maintainability.

Frequently Asked Questions about create-subagent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom subagent in Cursor?

Create a markdown file in .cursor/agents/ or ~/.cursor/agents/ with YAML frontmatter containing a name and description, followed by the system prompt body. The description determines when the AI delegates tasks to the subagent.

What is the difference between project and user subagents in Cursor?

Project subagents live in .cursor/agents/ and apply only to the current codebase, making them ideal for team sharing via version control. User subagents in ~/.cursor/agents/ are personal and available across all projects, with project-level taking priority on name conflicts.

What fields are required in a Cursor subagent file?

Only name and description are required in the YAML frontmatter. The name must use lowercase letters and hyphens, and the description should be specific enough for the AI to know when to delegate, ideally including proactive trigger language.

Why is my Cursor subagent not being found?

Verify the file is in .cursor/agents/ or ~/.cursor/agents/, has a .md extension, and contains valid YAML frontmatter. Syntax errors in the frontmatter or a wrong directory location are the most common causes.

How do I make a subagent trigger automatically?

Write a specific description that includes trigger terms and phrases like "use proactively" or "use immediately after writing code." Vague descriptions cause the AI to skip delegation, while actionable ones encourage automatic invocation.