update-component-reference

Update Component Reference Skill

Add documentation for Claude Code components (commands, agents, skills, hooks, MCP servers) to the website's Component Reference section.

When to Use

Use this skill when the user requests to:

• Add a new component to the Component Reference documentation
• Document a newly created command, agent, skill, hook, or MCP server
• Update component documentation in the reference section

Prerequisites Checklist

Before documenting a component, ensure:

1. Component exists in the appropriate plugin directory:

   • Commands: plugins/handbook/commands/{name}.md
   • Agents: plugins/handbook/agents/{name}.md
   • Skills: plugins/handbook/skills/{name}/SKILL.md
   • Hooks: plugins/{plugin-name}/hooks/hooks.json and hook scripts
   • MCP Servers: plugins/{plugin-name}/.mcp.json

2. For skills only: Component is registered in plugin.json:

   {
     "skills": [
       "./skills/skill-creator",
       "./skills/{new-skill-name}"
     ]
   }
   

3. Verify plugin name: Check .claude-plugin/plugin.json for the badge (e.g., "handbook", "handbook-dotnet")

Implementation Process

Step 1: Determine Target Directory

Component documentation goes in: website/docs/component-reference/{type}/

• Commands → website/docs/component-reference/commands/
• Agents → website/docs/component-reference/agents/
• Skills → website/docs/component-reference/skills/
• Hooks → website/docs/component-reference/hooks/
• MCP Servers → website/docs/component-reference/mcp-servers/

All category directories and _category_.json files already exist for these types.

Step 2: Determine sidebar_position

Read existing .mdx files in the target directory to find the highest sidebar_position and add 1.

Example:

grep -h "sidebar_position:" website/docs/component-reference/skills/*.mdx | sort -n

Step 3: Create Component Documentation File

Filename convention: Use kebab-case matching the component name

• Command /commit → commit.mdx
• Agent @backend-architect → backend-architect.mdx
• Skill skill-creator → skill-creator.mdx
• Hook csharp-formatter → csharp-formatter.mdx
• MCP Server context7 → context7.mdx