Document Specialist ships as one directory that four clients can load.
| Client | Manifest | Skills path |
|---|---|---|
| Universal / Agent Plugins 1.0 | plugin.json |
skills/ plus repo-root SKILL.md ("skills": "./") |
| Claude Code | .claude-plugin/plugin.json |
repo root SKILL.md plus skills/ |
| Grok Build | .grok-plugin/plugin.json |
Claude layout, zero-config |
| Codex | .codex-plugin/plugin.json |
skills/ |
| Cursor | .cursor-plugin/plugin.json |
skills/ |
Root file. Schema https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
name:document-specialistskills:./extensionspoint at host manifests so a client that understands reverse-domain extras can load hooks later
A client that only understands Agent Plugins 1.0 ignores .claude-plugin/ and still loads SKILL.md (and skills/documentation-specialist/SKILL.md as a copy).
.claude-plugin/plugin.json plus .claude-plugin/marketplace.json so the repo is its own marketplace.
claude plugin marketplace add SpillwaveSolutions/document-specialist-skill
claude plugin install document-specialist
Grok Build also loads Claude plugins zero-config when .claude-plugin/ exists.
.grok-plugin/plugin.json and .grok-plugin/marketplace.json. Pin the marketplace, or rely on the Claude layout.
skilz install SpillwaveSolutions_document-specialist-skill/documentation-specialist
.codex-plugin/plugin.json sets "skills": "./skills/" (a single path string, not an array) and Codex interface metadata: display name, default prompts, category Productivity.
Default prompts:
- Write DESIGN_DOC.md for this repo using arc42.
- Create an architecture document with C4-style Mermaid.
- Reverse-engineer an SDD from this Spring Boot service.
.cursor-plugin/plugin.json mirrors the universal name and description. Optional .cursor/rules can point at SKILL.md.
| Path | Role |
|---|---|
DESIGN_DOC.md |
arc42 SDD of Document Specialist itself |
skills/documentation-specialist/references/templates/markdown/DESIGN_DOC.md |
arc42 SDD template |
skills/documentation-specialist/references/templates/markdown/architecture.md |
Short C4 architecture template |
skills/documentation-specialist/references/workflows/design-workflow.md |
Intent DESIGN |
skills/documentation-specialist/references/examples/greenfield/ecommerce-sdd.md |
Greenfield few-shot |
skills/documentation-specialist/references/examples/greenfield/architecture-doc.md |
Short-form few-shot |
skills/documentation-specialist/references/examples/greenfield/ui-wireframes.md |
PlantUML Salt few-shot |
skills/documentation-specialist/references/examples/brownfield/spring-boot-sdd.md |
Brownfield few-shot |
commands/write-sdd.md |
Slash command |
commands/write-architecture.md |
Slash command |
commands/write-wireframe.md |
Slash command |
# Skilz (30+ agents)
skilz install SpillwaveSolutions_document-specialist-skill/documentation-specialist
# Claude Code
claude plugin marketplace add SpillwaveSolutions/document-specialist-skill
claude plugin install document-specialist
# Codex
# enable the plugin from the Codex plugin UI, or copy into ~/.codex/plugins/
# Grok Build
# add the marketplace pin, or clone beside the project
After install, ask:
Write DESIGN_DOC.md for this repository. Use Google docs style. Include Mermaid context, sequence, and ER figures. Add PlantUML Salt wireframes for every UI.
The agent should load design-workflow.md, the arc42 template, and one example, then emit DESIGN_DOC.md.