skills.rest
ArangoGutierrez
ArangoGutierrezCOMMUNITY
Explore all skills by this author →
Website𝕏@CarlosEArangoGitHub

create-subagent

Create custom Cursor subagents with YAML frontmatter and system prompts.

3|Updated Jul 2, 2026
Search Tags:#system prompt#ai agent#subagent#create#yaml frontmatter#cursor#code reviewer
One-click install
npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill create-subagent-arangogutierrez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/ArangoGutierrez/claude-toolkit/tree/main/.cursor/skills-cursor/create-subagent
Command: npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill create-subagent-arangogutierrez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the guesswork from building specialized AI subagents in Cursor by providing a repeatable file format, placement rules, and prompt-writing guidance so agents are discovered and delegated to correctly. ## Core Features & Use Cases - Subagent File Format: Defines the required Markdown structure with YAML frontmatter (name, description) plus a system prompt body. - Scope Management: Explains project-level (.cursor/agents/) versus user-level (~/.cursor/agents/) placement and priority resolution. - Ready-Made Examples: Includes complete templates 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 reviews are delegated automatically after every code change. ## Quick Start Create a code-reviewer subagent in .cursor/agents that proactively reviews my code for quality and security after every change.

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/ (project scope) or ~/.cursor/agents/ (user scope) with YAML frontmatter containing a name and description, followed by the system prompt body. Then ask the AI to use the subagent by name.

What fields are required in a Cursor subagent file?▼

The YAML frontmatter requires name and description fields. The name must use lowercase letters and hyphens only, and the description should be specific so the AI knows when to delegate 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.

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. Invalid frontmatter syntax or wrong directory placement are the most common causes.

How do I make the AI automatically delegate to a subagent?▼

Write a specific description that includes trigger terms and phrases like "use proactively" or "use immediately after writing code." Vague descriptions like "helps with code" prevent the AI from knowing when to delegate.

Related Skills

Explore More Software Engineering Skills→
othercodeothercode

creating-agents

Create and test AI agents using a Test-Driven Development approach.

Official
Advanced
mkurmanmkurman
321

subagent-driven-development

Dispatch fresh subagents for each task with two-stage reviews.

Community
Advanced
tronghieutronghieu
36

bmad-generate-project-context

Generate a project-context.md with implementation rules for AI agents.

Community
Advanced
GamezarGamezar

customaize-agent-create-workflow-command

Generate workflow commands orchestrating multi-step subagent execution via file-based task prompts.

Community
Advanced