skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-subagent

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

Updated May 18, 2025
Search Tags:#code review#debugging#task automation#system prompt#subagent#agent configuration#cursor
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill create-subagent-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills-cursor/create-subagent
Command: npx skills add https://github.com/nthpaul/dotfiles --skill create-subagent-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create specialized Cursor subagents with custom system prompts so your AI assistance stays focused, reusable, and context-safe.

Core Features & Use Cases

  • Set up domain-focused subagents: Create new subagent types for tasks like code review, debugging, or data analysis with a dedicated workflow and output structure.
  • Control subagent scope and priority: Use project-level or user-level locations so the right subagent is selected when names collide.
  • Write delegation-ready descriptions: Craft precise triggers that tell Cursor when to route work to the subagent.
  • Reproducible configuration: Store project subagents in version control and keep prompts consistent across machines.

Quick Start

Create a new subagent markdown file with YAML frontmatter in .cursor/agents/ (or ~/.cursor/agents/) and then invoke it by name to perform your specialized task.

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 Cursor subagent for code review or debugging?▼

To create a custom Cursor subagent, write a markdown file with YAML frontmatter defining the name and description, plus a system prompt body defining behavior and delegation triggers. Store it in .cursor/agents/ or ~/.cursor/agents/.

What is a Cursor subagent and when do I need one for task automation?▼

A Cursor subagent is a specialized AI assistant configured with a custom system prompt for domain-specific tasks like code review, debugging, or data analysis. You need one when you want focused, reusable, and context-safe AI workflows.

Can I store Cursor subagent configurations in version control for reproducible setups?▼

Yes, you can store project-level Cursor subagent configurations in version control. By placing agent markdown files in the .cursor/agents/ directory, you keep system prompts consistent and reproducible across machines and team members.

How do I control subagent scope and priority when names collide in Cursor?▼

You control subagent scope and priority by choosing the file location. Project-level subagents in .cursor/agents/ take precedence over user-level subagents in ~/.cursor/agents/, ensuring the correct agent is selected when names collide.

What's the best way to write delegation-ready descriptions for Cursor subagents?▼

The best way to write delegation-ready descriptions for Cursor subagents is to craft precise trigger phrases in the YAML frontmatter that tell Cursor exactly when to route work to that specific subagent based on the task context.

Related Skills

Explore More Software Engineering Skills→
rkz91rkz91
264

create-rule

Create and enforce Cursor rules in .cursor/rules/ with .mdc files.

Community
Intermediate
shankurshankur

create-subagent

Create custom subagents in Cursor with custom prompts and system instructions.

Community
Intermediate
JohnWebb4JohnWebb4

create-subagent

Create isolated Cursor subagents from Markdown files with YAML frontmatter.

Community
Intermediate
caeziumcaezium
2

create-subagent

Create Cursor subagents with Markdown files and YAML frontmatter.

Community
Intermediate