@ahood/cli 0.10.1 → 0.12.0

package/dist/useme/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ahood
-description: How to use the ahood CLI (@ahood/cli), the registry for reusable AI-agent skills, subagent definitions (AGENT.md), and MCP server manifests (server.json). Load BEFORE running any ahood command; before writing a non-trivial reusable skill, subagent, or MCP integration from scratch (search the registry first); when installing, updating, removing, publishing, sharing, or unpublishing one; when wiring ahood into an MCP host; or when setting up headless/CI access with AHOOD_TOKEN. Triggers - ahood, skill registry, is there a skill for this, install a skill, install an agent, add an MCP server, publish a skill, ahood mcp, AHOOD_TOKEN.
+description: How to use the ahood CLI (@ahood/cli), the registry for reusable AI-agent skills, subagent definitions (AGENT.md), MCP server manifests (server.json), docs (DOC.md), and project guides (PROJECT.md). Load BEFORE running any ahood command; before writing a non-trivial reusable skill, subagent, or MCP integration from scratch (search the registry first); when installing, updating, removing, publishing, sharing, or unpublishing one; when wiring ahood into an MCP host; or when setting up headless/CI access with AHOOD_TOKEN. Triggers - ahood, skill registry, is there a skill for this, install a skill, install an agent, add an MCP server, read a doc, project guide, publish a skill, ahood mcp, ahood doc, ahood project, AHOOD_TOKEN.
 ---
 
 # ahood
@@ -13,28 +13,37 @@ and only moves when someone runs an update.
 This guide ships inside the CLI itself (`ahood help useme`), so it matches the installed
 version (`ahood --version`). It needs no login or network to print.
 
-## Three kinds, three command groups
+## Five kinds, five command groups
 
 | Kind | Root file | Installs to | Commands |
 |---|---|---|---|
 | skill | `SKILL.md` | `.claude/skills/<owner>@<skill>/` | `ahood skill <verb>` |
 | agent | `AGENT.md` | `.claude/agents/<owner>@<agent>.md` | `ahood agent <verb>` |
 | mcp | `server.json` | an entry merged into `.mcp.json` | `ahood mcp <verb>` |
+| doc | `DOC.md` | `.claude/docs/<owner>@<doc>.md` | `ahood doc <verb>` |
+| project | `PROJECT.md` | `.claude/project.md` (one per repository) | `ahood project <verb>` |
 
-All three groups take the same verbs: `search`, `list`, `view`/`show`, `read`, `versions`,
+All five groups take the same verbs: `search`, `list`, `view`/`show`, `read`, `versions`,
 `diff`, `add`, `update`, `outdated`, `remove`, `edit`, `unpublish`, `star`, `unstar`,
 `share`, `unshare`, `init`, `publish`.
 
-- `ahood agent <verb>` and `ahood mcp <verb>` act on their own kind only. A target of another
-  kind is refused (exit 2) before anything is downloaded, prompted for, written, or sent,
-  and the error names the kind it found and the right command.
+- `ahood agent <verb>`, `ahood mcp <verb>`, `ahood doc <verb>` and `ahood project <verb>` act on their own kind only.
+  A target of another kind is refused (exit 2) before anything is downloaded, prompted for,
+  written, or sent, and the error names the kind it found and the right command.
 - `ahood skill <verb>` is the **legacy, cross-kind** group in this CLI release: `skill search`
   and `skill list` include every kind, and `skill add`/`skill update` install whatever kind
-  they resolve. Add `--kind skill` (or `agent`, `mcp`) to any verb to scope it to one kind;
+  they resolve, except a doc or project guide: `skill add` refuses one and points at
+  `ahood doc add` / `ahood project add`.
+  Add `--kind skill` (or `agent`, `mcp`, `doc`, `project`) to any verb to scope it to one kind;
   `--kind all` spells out the legacy behavior. Prefer the kind-specific form in anything new --
   a future major version makes `ahood skill` skills-only.
-- The registry also has a `doc` kind (documentation pages). This CLI has no `doc` group;
-  browse those on the website.
+- A doc is a documentation page. `ahood doc read alice/setup-guide` prints it without
+  installing anything; `ahood doc add alice/setup-guide` saves it as one pinned file under
+  `.claude/docs/`, which `ahood doc update` and `ahood doc remove` manage like any other pin.
+- A project guide is how to work in one repository: conventions, verification, traps. Run bare
+  `ahood project` inside a repository to list the guides naming its git remote;
+  `ahood project add alice/acme-api` saves one to `.claude/project.md` (pinned, one per
+  repository) and never touches `CLAUDE.md` or `AGENTS.md` -- point those at it yourself.
 
 ## Find, inspect, then install
 
@@ -84,7 +93,7 @@ ahood skill update --dry-run --json    # preview, machine-readable
 ahood agent remove alice/code-reviewer # local uninstall; prompts unless --yes
 ```
 
-With no target, `agent`/`mcp` `update` and `outdated` consider only installed pins of that
+With no target, `agent`/`mcp`/`doc`/`project` `update` and `outdated` consider only installed pins of that
 kind; the legacy `skill update` covers every pin. Updates only affect the current project.
 An `.mcp.json` entry you edited by hand is refused rather than overwritten.
 
@@ -96,13 +105,15 @@ Scaffold a valid starter, edit it, then publish an immutable semver version:
 ahood skill init pdf-tools             # ./pdf-tools/SKILL.md
 ahood agent init code-reviewer         # ./code-reviewer/AGENT.md
 ahood mcp init github-server           # ./github-server/server.json (placeholder URL)
+ahood doc init setup-guide             # ./setup-guide/DOC.md
+ahood project init acme-api            # ./acme-api/PROJECT.md, `project:` filled from git origin
 
 ahood agent publish alice/code-reviewer@1.0.0 --path code-reviewer --name "Code Reviewer"
 ahood skill publish alice/pdf-tools@1.1.0 --path pdf-tools --changelog "Adds split"
 ```
 
 - `--name` is required only on the first publish, which creates the entry under your
-  account. `agent publish`/`mcp publish` imply the kind and refuse a contradictory `--kind`
+  account. `agent publish`/`mcp publish`/`doc publish`/`project publish` imply the kind and refuse a contradictory `--kind`
   or an existing entry of another kind before uploading anything.
 - **New entries are private.** Make one discoverable explicitly:
   `ahood skill edit alice/pdf-tools --visibility public`.
@@ -149,7 +160,7 @@ ahood skill publish alice/pdf-tools@1.1.0 --path pdf-tools --changelog "Adds spl
 3. **The hosted registry MCP endpoint**, `https://www.ahood.dev/api/mcp`: Streamable HTTP,
    stateless (POST only), `Authorization: Bearer <token>`. It has write tools too:
    `search_skills`, `get_skill`, `fetch_skill`, `read_skill`, `list_skill_versions`,
-   `list_my_skills`, `search_collections`, `get_collection`, `create_skill`, `update_skill`,
+   `list_my_skills`, `search_collections`, `get_collection`, `get_project_guide`, `create_skill`, `update_skill`,
    `report_skill`, `delete_skill`, `yank_version`, and snap tools (`create_snap`,
    `list_snaps`, `get_snap`, `set_snap_tags`, `delete_snap`, `share_snap`, `unshare_snap`).
    A client that opens with a legacy-SSE `GET` gets a 405 -- use a Streamable HTTP client.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahood/cli",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "CLI for ahood, a registry for installing and publishing Claude Code skills.",
   "license": "MIT",
   "homepage": "https://github.com/AlexKay28/ahood-cli",