skills.rest
ferrarifankid04
ferrarifankid04COMMUNITY
Explore all skills by this author →
GitHub

create-subagent

Create custom Cursor subagents with YAML frontmatter and system prompts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up specialized AI assistants in Cursor requires knowing the correct file locations, frontmatter format, and description conventions. This Skill guides you through creating subagents that isolate context, specialize behavior, and reuse configurations across projects. ## Core Features & Use Cases - Subagent File Creation: Generate .md subagent files with valid YAML frontmatter (name and description) placed in .cursor/agents/ or ~/.cursor/agents/. - Ready-Made Templates: Includes complete examples for a code reviewer, debugger, and data scientist subagent with full system prompts. - Delegation Optimization: Explains how to write descriptions with trigger terms and "use proactively" phrasing so the AI delegates tasks automatically. - Use Case: After a long debugging session, ask the AI to create a dedicated debugger subagent so future error investigations run in an isolated context with a root-cause-analysis workflow. ## Quick Start Create a Cursor subagent named code-reviewer 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/ (project scope) or ~/.cursor/agents/ (user scope) with YAML frontmatter containing a name and description. 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-level files take priority on name conflicts.

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 a wrong directory 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 such as "helps with code" prevent the AI from knowing when to delegate.

Related Skills

Explore More Software Engineering Skills→
louloulinlouloulin
19

context-fork-skill

Create forked sub-agent contexts with isolated history and controlled tool access.

Community
Advanced
microsoftmicrosoft
4.9k

handle-large-tasks

Splits large plans into subagent tasks with tests to manage context windows.

Official
Intermediate
pulak999pulak999

migrate-to-skills

Convert Cursor rules and slash commands into Agent Skills format.

Community
Intermediate
opencueopencue
3

colony

Coordinate coding agents with claims, handoffs, and health monitoring.

Official
Intermediate