Agent skill

create-do

Create a new discipline plugin with specialized agents

View SKILL.md on GitHub Repository
Stars 129
Forks 14

Install this agent skill to your Project

npx add-skill https://github.com/TheBushidoCollective/han/tree/main/.claude/skills/create-do

SKILL.md

Create a Discipline (道 - Do) Plugin

Create a new discipline plugin for: $ARGUMENTS

What is a Discipline Plugin?

Discipline plugins represent "the way" or path of mastery in the Han marketplace. They provide specialized agents that embody expertise in specific development disciplines. Each discipline contains one or more agents with deep domain knowledge.

Plugin Structure

Create the following directory structure:

plugins/disciplines/{discipline-name}/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata (ONLY plugin.json goes here)
├── agents/
│   └── {agent-name}.md     # Agent definition
├── han-plugin.yml           # Han configurations (at plugin root)
├── hooks/
│   └── hooks.json           # Claude Code hooks (optional)
├── skills/
│   └── {skill-name}/
│       └── SKILL.md        # Skill documentation (optional)
└── README.md               # Plugin documentation

IMPORTANT:

  • Only plugin.json goes inside .claude-plugin/
  • hooks.json goes in the hooks/ directory
  • han-plugin.yml stays at the plugin root (NOT in hooks/)
  • Discipline names should be descriptive (e.g., frontend-development, api-engineering, security-engineering)

Step 1: Create plugin.json

Create .claude-plugin/plugin.json:

json
{
  "name": "{discipline-name}",
  "version": "1.0.0",
  "description": "Specialized agents for {discipline area} including {key responsibilities}.",
  "author": {
    "name": "The Bushido Collective",
    "url": "https://thebushido.co"
  },
  "homepage": "https://github.com/thebushidocollective/han",
  "repository": "https://github.com/thebushidocollective/han",
  "license": "MIT",
  "keywords": [
    "{discipline}",
    "{specialty}",
    "agent",
    "{related-area}"
  ]
}

Step 2: Create han-plugin.yml

Create han-plugin.yml at the plugin root:

yaml
# {discipline-name} plugin configuration
# This plugin provides specialized agents for {discipline area}

# No hooks for agent-focused plugins (unless needed)
hooks: {}

# No MCP server (unless this discipline provides one)
mcp: null

# Memory provider (optional)
memory: null

Step 3: Create Agent Definitions

For each specialized role, create an agent markdown file.

Agent File: agents/{agent-name}.md

markdown
---
name: {agent-name}
description: |
  {One-paragraph description of the agent's expertise, focus areas, and when to invoke them.}
model: inherit
color: {purple|blue|green|red|yellow|cyan|magenta}
---

# {Agent Title}

## Role

{Detailed description of the agent's role and expertise}

## Core Responsibilities

### {Responsibility Area 1}
- {Specific capability}
- {Specific capability}

## Approach

1. **{Step 1}**: {What the agent does}
2. **{Step 2}**: {What the agent does}

## When to Invoke

- {Specific scenario}
- {Specific scenario}

Agent Color Guidelines

  • purple: Design, UI/UX, presentation
  • blue: Architecture, planning, infrastructure
  • green: Testing, quality, reliability
  • red: Security, performance, critical systems
  • yellow: Documentation, communication
  • cyan: Data, analytics, integration
  • magenta: Creative, experimental, research

Step 4: Write README.md

markdown
# {Discipline Name}

{Description of the discipline and what these agents provide}

## Specialized Agents

### {Agent 1 Name}
{Description} | **Invoke when**: {Specific scenarios}

### {Agent 2 Name}
{Description} | **Invoke when**: {Specific scenarios}

## Installation

\`\`\`bash
han plugin install {discipline-name}
\`\`\`

Step 5: Register in Marketplace

Add your plugin to .claude-plugin/marketplace.json:

json
{
  "name": "{discipline-name}",
  "description": "Specialized agents for {discipline area} including {key responsibilities}.",
  "source": "./plugins/disciplines/{discipline-name}",
  "category": "Discipline",
  "keywords": [
    "{discipline}",
    "{specialty}",
    "agent"
  ]
}

Naming Guidelines

Discipline names should be descriptive and specific:

Good Too Generic
frontend-development frontend
api-engineering api
security-engineering security
database-engineering databases
site-reliability-engineering sre

Examples of Well-Structured Discipline Plugins

  • frontend-development: Excellent agent definitions with clear roles
  • security-engineering: Strong technical depth
  • system-architecture: Good balance of strategy and implementation

Questions?

See the Han documentation or ask in GitHub Discussions.

Didn't find tool you were looking for?

Be as detailed as possible for better results