update-component-reference

Create documentation by generating an `.mdx` file in `website/docs/component-reference/{type}` with proper frontmatter, title, and import path. The Skill automates this process for commands, agents, skills, hooks, and MCP servers, ensuring consistent formatting and correct sidebar positioning.

MDX documentation requires frontmatter with sidebar_position, a title matching the component name, and import statements for Claude Code components. The Skill enforces correct template usage and validates import paths to maintain consistency across the component reference.

The Skill automatically determines the appropriate `sidebar_position` for new documentation entries, eliminating manual calculation. It maintains organized navigation by calculating position based on existing entries in the target component-reference directory.

Components must exist in correct directories, skills require `plugin.json` registration, and all entries must follow MDX/template standards. The Skill enforces these prerequisites and validates directory placement before generating documentation.

Yes, the Skill applies to both creating new entries and updating existing documentation. It handles modification of commands, agents, skills, hooks, and MCP server docs while maintaining proper formatting and import path validation.

Documentation uses `.mdx` files stored in `website/docs/component-reference/{type}` directories organized by component type. MDX enables both markdown content and React component integration for interactive documentation.