subagent-guide

Structure subagent prompts with context, critical thinking, and worktree isolation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MoonBoi9001/claude-code-cli-tools --skill subagent-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-guide
Source: https://github.com/MoonBoi9001/claude-code-cli-tools/tree/main/skills/subagent-guide
Command: npx skills add https://github.com/MoonBoi9001/claude-code-cli-tools --skill subagent-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Subagents start with zero context about the current project, problem, or conversation. They cannot ask clarifying questions — they work with what you provide. The quality of their output directly correlates with the completeness of your prompt.

Core Features & Use Cases

  • Critical Context Principle: prompts should include all necessary information to operate without asking for clarifications.
  • Critical Thinking Requirement: prompts must include sanity checks, domain awareness, and guardrails to prevent flawed implementations.
  • Worktree Isolation guidance: use isolation: "worktree" when launching multiple agents against the same repository.
  • Model Selection and Coding Standards: follow the latest Opus model guidance and CODING-STANDARDS.md for implementation and safety.

Quick Start

Describe the task, constraints, and success criteria in a single, comprehensive prompt before delegating any work to a subagent.

Frequently Asked Questions about subagent-guide

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

FAQPage Schema
How do I provide context to subagents that start with zero knowledge of my project?

To provide context to subagents with zero knowledge, include all necessary task details, constraints, and success criteria in a single comprehensive prompt before delegation, ensuring they can operate without asking clarifying questions.

How do I prevent subagents from making flawed implementations in code projects?

Prevent flawed implementations by embedding critical thinking requirements into your prompts, adding sanity checks, domain awareness, and guardrails to guide subagents against unsafe or incorrect coding patterns.

When should I use worktree isolation for agent coordination?

Use worktree isolation when launching multiple agents against the same repository, preventing file conflicts and ensuring safe agent coordination by isolating each agent's working directory.

What coding standards should subagent prompts reference for safe delegation?

Subagent prompts should reference CODING-STANDARDS.md and the latest Opus model guidance to enforce implementation safety, ensuring subagents follow established coding conventions during task execution.

What is the best way to structure a prompt for background agents?

The best way to structure background agent prompts is describing the task, constraints, and success criteria comprehensively in a single prompt, applying the Critical Context Principle for safe and effective delegation.

Why do subagents produce poor quality output despite detailed instructions?

Subagents produce poor output when prompts lack critical thinking requirements or sufficient context, as they cannot ask clarifying questions and rely entirely on the completeness of provided information for execution.