subagents-reference

Configure Claude Code subagents with YAML frontmatter in SKILL.md files.

1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Dunc4nJ/entropy-plugins --skill subagents-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagents-reference
Source: https://github.com/Dunc4nJ/entropy-plugins/tree/main/claude-code-docs/skills/subagents-reference
Command: npx skills add https://github.com/Dunc4nJ/entropy-plugins --skill subagents-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code subagents can be complex to configure and maintain. This skill provides a centralized reference detailing agent types, prompts, tools, and lifecycle hooks to standardize creation and usage across projects.

Core Features & Use Cases

  • Templates and patterns for project and user subagents
  • Guidance on prompts, tool access, permissions, and hooks
  • Onboarding and documentation for teams extending Claude Code workflows

Quick Start

Open the /agents interface to explore built-in and custom subagents and consult the subagents-reference to model new configurations.

Frequently Asked Questions about subagents-reference

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

FAQPage Schema
How do I configure Claude Code subagents with YAML frontmatter and prompts?

Claude Code subagents are configured using YAML frontmatter in SKILL.md files, defining required fields like name and description, alongside structured documentation for prompts, hooks, and tool permissions. This reference standardizes creation and usage across projects.

What are Claude Code subagents and when do I need them in my workflow?

Claude Code subagents are customizable agents that extend workflows with specific prompts, tools, and lifecycle hooks. Teams need them when onboarding or managing advanced configurations that require standardized agent types across multiple projects.

Can I manage tool access and permissions for custom subagents in Claude Code?

Yes, custom subagents support configurable tool access and permissions. This reference provides guidance on setting up tool permissions within the agent configuration, ensuring agents operate within defined access boundaries and hooks.

What's the best way to structure documentation for project and user subagents?

The best way to structure subagent documentation is using YAML frontmatter with name and description fields, followed by organized sections covering prompts, hooks, and tool permissions. Templates and patterns for both project and user subagents are provided.

Does Claude Code support lifecycle hooks for subagent automation?

Yes, Claude Code supports lifecycle hooks for subagents. This reference details how to implement hooks alongside prompts and tools, enabling teams to automate workflows and standardize subagent behavior across different project environments.

Why are my Claude Code subagent configurations not following the correct format?

Subagent configurations fail when SKILL.md files omit required YAML frontmatter fields like name and description, or lack structured guidance on prompts, hooks, and tool permissions. This reference ensures configurations meet the required documentation structure.