| name | Build-Assistant |
| description | Build Claude Code framework components (agents, slash commands, skills, plugins) following standardized templates. Use when creating new agents, commands, skills, or plugins for the multiagent framework. |
| allowed-tools | Read, Write, Bash |
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 frontmattertemplates/agents/agent-example.md- Complete working example
Commands:
templates/commands/command.md.template- Standard slash command templatetemplates/commands/command-example.md- Complete working example
Skills:
templates/skills/SKILL.md.template- Standard skill templatetemplates/skills/skill-example/SKILL.md- Git commit helper exampletemplates/skills/README.md- Skills template documentation
Plugins:
templates/plugins/plugin.json.template- Plugin manifest templatetemplates/plugins/example-plugin/- Complete plugin example with commands and skills
Validation Scripts
scripts/validate-agent.sh- Validates agent frontmatter and structurescripts/validate-command.sh- Validates command frontmatter and structurescripts/validate-skill.sh- Validates SKILL.md frontmatter and "Use when" contextscripts/validate-plugin.sh- Validates plugin manifest and structurescripts/test-build-system.sh- Comprehensive build system test suite
Documentation
docs/01-claude-code-slash-commands.md- Slash command referencedocs/02-claude-code-skills.md- Skills reference with frontmatter fieldsdocs/03-claude-code-plugins.md- Plugin architecture and structuredocs/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