skills.rest
shoshoavi
shoshoaviCOMMUNITY
Explore all skills by this author →
GitHub

create-subagent

Create custom Cursor subagents with YAML frontmatter and markdown system prompts.

Updated Apr 15, 2026
Search Tags:#system prompt#subagent#ai assistant#create#yaml frontmatter#cursor#code reviewer
One-click install
npx skills add https://github.com/shoshoavi/agentic_worflows --skill create-subagent-shoshoavi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/shoshoavi/agentic_worflows/tree/main/cursor/skills-cursor/create-subagent
Command: npx skills add https://github.com/shoshoavi/agentic_worflows --skill create-subagent-shoshoavi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers need specialized AI assistants for recurring tasks like code review or debugging, but configuring isolated agents with custom system prompts and correct file placement is error-prone without guidance. ## Core Features & Use Cases - Subagent File Authoring: Guides creation of .md files with required YAML frontmatter fields (name, description) and a markdown body that becomes the system prompt. - Scope Management: Explains project-level (.cursor/agents/) versus user-level (~/.cursor/agents/) placement and priority resolution when names collide. - Ready-Made Templates: Provides complete examples for a code reviewer, debugger, and data scientist subagent with effective delegation descriptions. - Use Case: After repeatedly asking the AI to review code, create a code-reviewer subagent with a proactive description so the AI automatically delegates review tasks to it. ## Quick Start Create a code-reviewer subagent in my project's .cursor/agents directory that proactively reviews code for quality and security.

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 .md file in .cursor/agents/ (project scope) or ~/.cursor/agents/ (user scope) with YAML frontmatter containing name and description fields. The markdown body below the frontmatter becomes the subagent's system prompt.

What fields are required in a Cursor subagent file?▼

Two frontmatter fields are required: name, a unique identifier using lowercase letters and hyphens, and description, which tells the AI when to delegate to the subagent. The description should be specific and include trigger terms.

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. Project subagents take priority when names collide.

Why is my Cursor subagent not being found?▼

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

How do I make the AI automatically use my subagent?▼

Write a specific description that includes trigger terms and phrases like "use proactively" so the AI knows when to delegate. Vague descriptions like "helps with code" rarely trigger automatic delegation.

Related Skills

Explore More Software Engineering Skills→
maplin-comaplin-co

skill-creator

Create AI skills with SKILL.md format and optional resource directories.

Official
Basic
janjaszczakjanjaszczak

create-subagent

Create and deploy custom subagents for specialized tasks with Markdown system prompts.

Community
Intermediate
kasperjungekasperjunge
450

migrate-to-skills

Convert legacy subagents, slash commands, and rules into SKILL.md-based skills.

Community
Intermediate
22Teikk22Teikk

doubt-driven-development

Reviews non-trivial code decisions with adversarial fresh-context reviewers before they stand.

Community
Advanced