Build-Assistant
This skill provides templates, validation scripts, and documentation for building Claude Code framework components following the multiagent framework standards.
Instructions
When Creating a New Agent
- •Read the agent template:
templates/agents/agent.md.template - •Read the agent example:
templates/agents/agent-example.md - •Read documentation:
docs/claude-code-agents.md(if available) - •Create agent file with:
- •Proper frontmatter (name, description, tools, model, color)
- •Clear process steps
- •Key rules and output format
- •Validate using:
scripts/validate-agent.sh <agent-file>
When Creating a Slash Command
- •Read the command template:
templates/commands/command.md.template - •Read the command example:
templates/commands/command-example.md - •Read documentation:
docs/01-claude-code-slash-commands.md - •Create command file with:
- •Frontmatter (description, argument-hint, allowed-tools)
- •Task invocation with proper subagent_type
- •Success criteria and notes
- •Validate using:
scripts/validate-command.sh <command-file>
When Creating a Skill
- •Read the skill template:
templates/skills/SKILL.md.template - •Read the skill example:
templates/skills/skill-example/SKILL.md - •Read documentation:
docs/02-claude-code-skills.md - •Read decision guide:
docs/04-skills-vs-commands.md - •Create SKILL.md with:
- •Frontmatter with "Use when" trigger context
- •Step-by-step instructions
- •Concrete examples
- •Requirements
- •Validate using:
scripts/validate-skill.sh <skill-directory>
When Creating a Plugin
- •Read the plugin template:
templates/plugins/plugin.json.template - •Read the plugin example:
templates/plugins/example-plugin/ - •Read documentation:
docs/03-claude-code-plugins.md - •Create plugin structure with:
- •
.claude-plugin/plugin.jsonmanifest - •README.md with components list
- •commands/, skills/, agents/ as needed
- •
- •Validate using:
scripts/validate-plugin.sh <plugin-directory>
Choosing Between Skills and Commands
Consult docs/04-skills-vs-commands.md to decide:
- •Use Skill when: Claude should discover it automatically, complex capability, multiple supporting files
- •Use Command when: User explicitly triggers it, simple orchestration, workflow shortcut
Available Resources
Templates
Agents:
- •
templates/agents/agent.md.template- Standard agent template with frontmatter - •
templates/agents/agent-example.md- Complete working example
Commands:
- •
templates/commands/command.md.template- Standard slash command template - •
templates/commands/command-example.md- Complete working example
Skills:
- •
templates/skills/SKILL.md.template- Standard skill template - •
templates/skills/skill-example/SKILL.md- Git commit helper example - •
templates/skills/README.md- Skills template documentation
Plugins:
- •
templates/plugins/plugin.json.template- Plugin manifest template - •
templates/plugins/example-plugin/- Complete plugin example with commands and skills
Validation Scripts
- •
scripts/validate-agent.sh- Validates agent frontmatter and structure - •
scripts/validate-command.sh- Validates command frontmatter and structure - •
scripts/validate-skill.sh- Validates SKILL.md frontmatter and "Use when" context - •
scripts/validate-plugin.sh- Validates plugin manifest and structure - •
scripts/test-build-system.sh- Comprehensive build system test suite
Documentation
- •
docs/01-claude-code-slash-commands.md- Slash command reference - •
docs/02-claude-code-skills.md- Skills reference with frontmatter fields - •
docs/03-claude-code-plugins.md- Plugin architecture and structure - •
docs/04-skills-vs-commands.md- Decision guide for choosing component type
Requirements
- •Templates must exist in
templates/directory - •Validation scripts must be executable
- •Documentation files should be available in
docs/ - •Follow Claude Code standards for frontmatter
- •Include "Use when" context in skill descriptions
Best Practices
- •Always validate - Run validation scripts after creation
- •Follow templates - Use provided templates as starting point
- •Read examples - Study working examples before creating new components
- •Check documentation - Consult docs for standards and patterns
- •Test thoroughly - Use test-build-system.sh for comprehensive testing
Generated from: multiagent-build plugin build-assistant skill Purpose: Standardize framework component creation across multiagent ecosystem Load when: Creating agents, commands, skills, or plugins