packmind: Skill for Claude Code

Documentation Audit

Detect outdated, broken, or misleading documentation by cross-referencing MDX pages against the actual codebase. Produces a structured doc-audit-report.md at the project root.

This skill only detects issues — it does not fix them.

Tooling

Reach for Read, Glob and Grep before a shell. Every check here is "open a file" or "search the tree", and those three cover both. It matters because the scheduled run (.github/workflows/weekly-doc-review.yml) is non-interactive: it grants a small read-only shell allowlist and nobody is there to approve anything outside it, so a refused call spends a turn of a fixed budget and returns nothing. Paging through a file with head or sed when Read opens it whole loses either way.

Never cd. Every tool here takes a path relative to the repository root, so there is nothing to change directory for, and cd somewhere && ... is the one shape the allowlist can never admit: a prefix rule is matched against the whole command, so it does not match a compound one. That refusal cannot be granted by adding a rule — the only fix is not to write the command. Pass a path instead.

Phase 1: Build Ground Truth

Before auditing anything, build a concise ground truth summary by gathering these four data sources:

1. Navigation structure — Read apps/doc/docs.json and extract all navigation groups with their page lists
2. CLI commands — List files in apps/cli/src/infra/commands/ to get current command files
3. Domain packages — List directories in packages/ to get current package names
4. Doc MDX files — Glob apps/doc/**/*.mdx to get all actual pages on disk

Compile these into a ground truth summary string formatted as:

## Ground Truth

### Navigation Groups (from docs.json)
- Getting Started: index, getting-started/gs-install-cloud, ...
- Concepts: concepts/standards-management, ...
[list all groups]

### CLI Commands (from apps/cli/src/infra/commands/)
[list all *Command.ts and *Handler.ts files]

### Domain Packages (from packages/)
[list all package directory names]

### MDX Files on Disk (from apps/doc/**/*.mdx)
[list all .mdx file paths relative to apps/doc/]

### Current Date
{today's date}