Skills
The opencodehub Claude Code plugin ships two families of skills:
- Analysis skills (pre-existing) —
opencodehub-exploring,opencodehub-impact-analysis,opencodehub-debugging,opencodehub-refactoring,opencodehub-pr-review,opencodehub-guide. These answer questions about the code graph. - Artifact skills (new in this release) — turn graph queries into committed Markdown. Documented below.
All artifact skills ship under plugins/opencodehub/skills/ and are
auto-discovered by Claude Code when the plugin is installed.
Artifact skills
Section titled “Artifact skills” codehub-document Primary artifact generator. Single-repo and group mode, 4-phase orchestration, .docmeta.json sidecar.
codehub-pr-description Draft a PR body from detect_changes + verdict + owners + findings-delta. Refuses on a clean tree.
codehub-onboarding ONBOARDING.md with a graph-centrality-ranked reading order and an end-to-end process walk.
codehub-contract-map Group-only. Consumer/producer contract matrix across a repo group, with Mermaid flow.
How they compose
Section titled “How they compose”The four skills share the OpenCodeHub MCP toolkit. codehub-document is
the only skill that dispatches subagents; the others are linear. All four
write to .codehub/ by default (gitignored); --committed opts in to a
git-tracked path.
Invocation cheatsheet
Section titled “Invocation cheatsheet”| Trigger phrase | Fires |
|---|---|
| ”document this repo” / “regenerate the architecture docs” | codehub-document |
”document the <group> group” / “map the repos in <group>” | codehub-document --group <name> |
| ”write the PR description” / “summarize this branch for review” | codehub-pr-description |
| ”draft release notes for HEAD” | codehub-pr-description |
| ”write ONBOARDING.md” / “what should a new hire read first” | codehub-onboarding |
”map the contracts” / “show the contract matrix for <group>” | codehub-contract-map <group> |
Discoverability hooks
Section titled “Discoverability hooks”The plugin hooks have been extended to surface the artifact skills at the right moments:
- After
codehub analyzecompletes, the CLI prints:Try: /codehub-document · /codehub-onboarding · /codehub-contract-map <group> - After
git commit|merge|rebase|pulltriggers auto-reindex, if.codehub/docs/.docmeta.jsonexists and itscodehub_graph_hashdiffers from the live hash, a non-blockingsystemMessagesuggests/codehub-document --refresh. Never auto-regenerates — regeneration spends LLM credits and requires user consent. mcp__opencodehub__verdictandmcp__opencodehub__detect_changesresponses includenext_steps: [{suggest: "codehub-pr-description"}]when a non-empty diff is present.