Can sub-agents created with this skill interact with users?

No, sub-agents operate in an isolated context and are forbidden from using tools like AskUserQuestion; they must report results back to the caller.

What is the mandatory structure for a sub-agent body?

A sub-agent must include a single H1 Title and a numbered Process section to define its execution steps clearly.

How should I handle skill navigation within an agent?

Use the Skill Usage section pattern to provide the agent with navigation pointers (section names) rather than duplicating content or using internal file paths.

Why does this skill recommend the 'skills' field in YAML?

The skills field allows sub-agents to automatically load necessary domain guidance or design skills upon initialization, ensuring consistent behavior.

Sub-agent Design Architect

Name: Sub-agent Design Architect
Author: racurry

byracurry

0•

Developer Tools

Guides the creation of high-performing Claude Code sub-agents by applying architectural best practices and avoiding common implementation pitfalls.

Sub-agent Design Architect provides interpretive guidance for developers building autonomous sub-agents within the Claude Code ecosystem. It bridges the gap between official documentation and practical implementation, offering structured patterns for agent body design, tool selection, and skill integration. By enforcing specific process flows and validation checklists, it ensures sub-agents remain robust, context-aware, and effective without requiring direct user interaction, leveraging the box-factory-architecture foundation.

Key Features

01Guidance on tool selection and the sub-agent isolation model

020 GitHub stars

03Workflow Selection Tables for complex architectural decisions

04Automated Skill Dependency Management via YAML configuration

05Inlined Quality Checklists for rigorous sub-agent validation

06Standardized Agent Body Structure (Process, Constraints, Skill Usage)

Use Cases

01Designing autonomous sub-agents for complex multi-step developer workflows

02Standardizing sub-agent patterns across a distributed plugin ecosystem

03Validating existing sub-agent implementations against industry best practices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add racurry/neat-little-package sub-agent-design

For use in Claude.ai and ChatGPT

Download Skill