> ## Documentation Index
> Fetch the complete documentation index at: https://theagenticguy.github.io/opencodehub/llms.txt
> Use this file to discover all available pages before exploring further.
> Scoped bundles: [user-guide](https://theagenticguy.github.io/opencodehub/_llms-txt/user-guide.txt) · [mcp](https://theagenticguy.github.io/opencodehub/_llms-txt/mcp.txt) · [contributing](https://theagenticguy.github.io/opencodehub/_llms-txt/contributing.txt)

# 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

[codehub-document](/opencodehub/skills/codehub-document/)
  [codehub-pr-description](/opencodehub/skills/codehub-pr-description/)
  [codehub-onboarding](/opencodehub/skills/codehub-onboarding/)
  [codehub-contract-map](/opencodehub/skills/codehub-contract-map/)
## How they compose

```mermaid
flowchart LR
  doc[codehub-document<br/>full doc tree] --> docmeta[.docmeta.json]
  pr[codehub-pr-description<br/>PR body] --> verdict
  onb[codehub-onboarding<br/>ONBOARDING.md] --> codegraph
  map[codehub-contract-map<br/>contracts.md] --> groupcontracts[group_contracts]
  verdict[verdict + impact + owners] --> codegraph[(code graph)]
  groupcontracts --> codegraph
  docmeta --> refresh[--refresh<br/>staleness hook]
```

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

| 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

The plugin hooks have been extended to surface the artifact skills at the
right moments:

- After `codehub analyze` completes, the CLI prints:
  `Try: /codehub-document · /codehub-onboarding · /codehub-contract-map <group>`
- After `git commit|merge|rebase|pull` triggers auto-reindex, if
  `.codehub/docs/.docmeta.json` exists and its `codehub_graph_hash` differs
  from the live hash, a non-blocking `systemMessage` suggests
  `/codehub-document --refresh`. **Never auto-regenerates** — regeneration
  spends LLM credits and requires user consent.
- `mcp__opencodehub__verdict` and `mcp__opencodehub__detect_changes`
  responses include `next_steps: [{suggest: "codehub-pr-description"}]`
  when a non-empty diff is present.