skills.rest
pulak999
pulak999COMMUNITY
Explore all skills by this author →
GitHub

create-subagent

Create custom Cursor subagents with YAML frontmatter and system prompts.

Updated Mar 21, 2026
Search Tags:#code review#system prompt#subagent#ai assistant#create#agent configuration#cursor
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill create-subagent-pulak999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/cursor-skills-cursor/create-subagent
Command: npx skills add https://github.com/pulak999/ai-tooling --skill create-subagent-pulak999

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, and mistakes cause subagents to be ignored or never delegated to. ## Core Features & Use Cases - Subagent File Authoring: Guides creation of .md subagent files with required name and description frontmatter plus a system prompt body. - Scope Selection: Explains project-level (.cursor/agents/) versus user-level (~/.cursor/agents/) placement and priority rules. - Ready-Made Examples: Provides complete templates for code reviewer, debugger, and data scientist subagents. - Use Case: After a debugging session, ask the AI to create a debugger subagent so future error investigations run in an isolated context with a root-cause-analysis workflow. ## Quick Start Create a code-reviewer subagent that proactively reviews my changes for quality and security issues.

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, followed by a markdown body that becomes the system prompt.

What fields are required in a Cursor subagent file?▼

Two frontmatter fields are required: name, a unique lowercase identifier with hyphens, and description, which tells the AI when to delegate to the subagent. The markdown body serves as the system prompt.

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

Project subagents live in .cursor/agents/ and apply only to the current codebase, while user subagents in ~/.cursor/agents/ apply across all projects. Project subagents take priority when names conflict.

Why is my Cursor subagent not being found or invoked?▼

Check that the file is in .cursor/agents/ or ~/.cursor/agents/, has a .md extension, and contains valid YAML frontmatter. Also write a specific description with trigger terms so the AI knows when to delegate.

How do I write a good subagent description for automatic delegation?▼

Write a specific, actionable description naming the task and trigger conditions, and include phrases like "use proactively" to encourage automatic delegation. Vague descriptions like "helps with code" rarely get invoked.

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
CatRabbit499CatRabbit499

code_review

Spawn an architect subagent for architectural analysis and planning guidance.

Community
Intermediate
PandelisZPandelisZ
1

create-subagent

Create and manage Cursor subagents with YAML frontmatter and system prompts.

Community
Intermediate
alangebalangeb

command_template

Create custom slash commands using Markdown templates or Python logic.

Community
Intermediate