skills.rest
JohnWebb4
JohnWebb4COMMUNITY
Explore all skills by this author →
GitHub

create-subagent

Create isolated Cursor subagents from Markdown files with YAML frontmatter.

Updated Feb 23, 2019
Search Tags:#workflow#subagent#ai-agent#cursor#yaml-frontmatter#prompt-design#agent-testing
One-click install
npx skills add https://github.com/JohnWebb4/dotfiles --skill create-subagent-johnwebb4
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-subagent
Source: https://github.com/JohnWebb4/dotfiles/tree/main/.cursor/skills-cursor/create-subagent
Command: npx skills add https://github.com/JohnWebb4/dotfiles --skill create-subagent-johnwebb4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams quickly compose and deploy specialized subagents for Cursor by standardizing frontmatter, prompts, and locations so agents can be reused across projects.

Core Features & Use Cases

  • Frontmatter-driven configuration for new subagents (name, description) as required.
  • Separate project-level (.cursor/agents) and user-level (~/.cursor/agents) subagents for collaboration and personal use.
  • Ready-made patterns for common roles (e.g., code-reviewer, debugger) with a clear workflow.

Quick Start

Create a new subagent by adding a Markdown file with a valid YAML frontmatter (name and description) in either .cursor/agents or ~/.cursor/agents and place the system prompt in the body.

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 specialized AI subagent in Cursor?▼

To create a Cursor subagent, add a Markdown file with YAML frontmatter defining the name and description, then place the system prompt in the body. Store the file under .cursor/agents or ~/.cursor/agents to deploy it.

What is the difference between project-level and user-level Cursor agents?▼

Project-level agents are stored in the .cursor/agents directory for team collaboration, while user-level agents reside in ~/.cursor/agents for personal workflows across multiple projects. Both require Markdown files with YAML frontmatter.

Does a Cursor subagent require YAML frontmatter?▼

Yes, YAML frontmatter is required for Cursor subagents. The frontmatter must include the name and description fields, while the body of the Markdown file contains the system prompt that defines the agent's specialized behavior.

What is the best way to set up a dedicated code reviewer agent in Cursor?▼

Setting up a code reviewer agent involves creating a Markdown file with the role description in YAML frontmatter and the review instructions as the system prompt in the body. Save it to .cursor/agents to standardize the workflow across your project.

Can I reuse the same AI agent across multiple Cursor projects?▼

Yes, you can reuse AI agents across multiple Cursor projects by placing the subagent Markdown file in the user-level directory at ~/.cursor/agents. This makes the agent available globally for your personal workflows.

Why is my Cursor subagent not showing up?▼

A Cursor subagent might not appear if the Markdown file is missing required YAML frontmatter fields like name and description, or if the file is not saved in the correct .cursor/agents or ~/.cursor/agents directory path.

Related Skills

Explore More Software Engineering Skills→
guilhermemarketingguilhermemarketing
59

cursor-subagent-creator

Create Cursor subagents with standardized frontmatter in .cursor/agents/.

Community
Advanced
coolguy1771coolguy1771

create-subagent

Create custom AI subagents with system prompts in the Cursor IDE.

Community
Intermediate
grasberggrasberg
3

prompt-engineer

Design and optimize prompts with structured schemas and evaluation frameworks.

Community
Advanced
kensauruskensaurus
8

create-subagent

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

Community
Intermediate