# Docs Inventory Surface

> Inventory the documented surface of a repository (commands, options, routes, configuration keys, public symbols) through the docs MCP tools. Use as the first step of docs-architect work.

- Skill: `drmoisan/docs-inventory-surface-3` (Agent Skill)
- Install (CLI): `npx get-skill add drmoisan/docs-inventory-surface-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drmoisan/docs-inventory-surface-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: drmoisan (https://skillmd.com/u/drmoisan)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/drmoisan/docs-inventory-surface-3

---


# Docs Inventory Surface

## When to Use This Skill

[docs-architect](../../agents/docs-architect.agent.md) runs this skill to
build the surface inventory and compare it with the persisted snapshot named by
the profile `artifact_paths.inventory_snapshot`.

## Prerequisites

Root steps run `Invoke-DocsCommand.ps1` from the docs helper library that the Claude customization push-down delivers, under PowerShell 7.4 or later. Without that library every root step in this skill is unavailable; the docs MCP tools stay available.

## Steps

1. Call `run_docs_inventory` with `workspace_root`, `profile`, and optionally
   `analyzers` and `revision` (40 or 64 lowercase hexadecimal characters). The tool
   returns the snapshot in its result and never writes it.
2. Compare the returned elements with the persisted snapshot: list added,
   removed and changed element ids.
3. When the snapshot must be persisted, report that the root step below is
   required; the role does not write the snapshot.
   Root step (unavailable without the docs helper library): `Invoke-DocsCommand.ps1 -Command inventory -Profile docs/documentation-estate/docs-profile.json -Write`

## Result

Report the snapshot path, the element counts by kind and the element ids that
changed.

