projectb-create-subagent

Create custom subagents with YAML frontmatter and markdown system prompts.

Updated May 28, 2023
One-click install
npx skills add https://github.com/steveulrich/ProjectB --skill projectb-create-subagent-steveulrich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: projectb-create-subagent
Source: https://github.com/steveulrich/ProjectB/tree/main/.agents/skills/projectb-create-subagent
Command: npx skills add https://github.com/steveulrich/ProjectB --skill projectb-create-subagent-steveulrich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up specialized AI assistants for recurring tasks like code review or debugging requires knowing the correct file format, directory locations, and configuration conventions, which this Skill documents and automates. ## Core Features & Use Cases - Subagent File Creation: Generates .md files with required YAML frontmatter (name and description) plus a markdown body that becomes the system prompt. - Scope Management: Distinguishes project-level subagents (.cursor/agents/) from user-level subagents (~/.cursor/agents/) with defined priority rules. - Ready-Made Templates: Includes complete examples for a code reviewer, debugger, and data scientist subagent. - Use Case: After repeatedly asking for security-focused code reviews, create a code-reviewer subagent with a proactive description so the AI delegates review tasks automatically. ## Quick Start Create a project-level subagent named code-reviewer that proactively reviews code for quality, security, and maintainability.

Frequently Asked Questions about projectb-create-subagent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom subagent for code review?▼

Create a `.md` file in `.cursor/agents/` with YAML frontmatter containing a `name` and `description`, then write the system prompt in the markdown body. Include "use proactively" in the description to encourage automatic delegation.

What is the difference between project and user subagents?▼

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

What fields are required in a subagent file?▼

Subagent files require two YAML frontmatter fields: `name` (lowercase letters and hyphens only) and `description` (when to delegate to the subagent). The markdown body below the frontmatter becomes the system prompt.

Why is my subagent not being found?▼

Subagent discovery fails when the file is outside `.cursor/agents/` or `~/.cursor/agents/`, lacks the `.md` extension, or contains invalid YAML frontmatter. Verify the file location, extension, and frontmatter syntax.

How do I write a description that triggers automatic delegation?▼

Write specific, actionable descriptions naming the exact task and trigger conditions, such as "Use immediately after writing or modifying code." Vague descriptions like "Helps with code" prevent the AI from knowing when to delegate.