How do I install the Alexnodeland Principled Docs Audit skill?

Run npx skillmds@latest add tomevault-io/alexnodeland-principled-docs-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Alexnodeland Principled Docs Audit skill do?

Docs Audit — Monorepo-Wide Documentation Audit It is listed under Security on SkillMD.

Is Alexnodeland Principled Docs Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Alexnodeland Principled Docs Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Alexnodeland Principled Docs Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Alexnodeland Principled Docs Audit?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Alexnodeland Principled Docs Audit by tomevault-io

Name: Alexnodeland Principled Docs Audit
Author: tomevault-io

File contents

Docs Audit — Monorepo-Wide Documentation Audit

Audit documentation health across all modules in the monorepo and produce an aggregate compliance report.

Command

/docs-audit [--modules-dir <path>] [--format summary|detailed] [--include-root]

Arguments

Argument	Required	Description
`--modules-dir <path>`	No	Root directory containing modules (default: `packages` or value from config)
`--format`	No	Output format: `summary` (default) or `detailed`
`--include-root`	No	Also validate the repo-level `docs/` structure

Workflow

Parse arguments. Extract options from $ARGUMENTS. Use defaults from project configuration where not specified.
Discover modules. Find all subdirectories under the modules directory that appear to be modules (contain a docs/ directory, README.md, or CLAUDE.md).
- Filter out modules matching ignoredModules glob patterns from project config.
Determine module types. For each discovered module:
- Read the module's CLAUDE.md and look for the ## Module Type section
- If not found, use defaultModuleType from project config
- If neither available, report the module as "unknown type" and skip validation
Validate each module. For each module with a known type, run the structural validation:
```
bash <plugin-root>/skills/scaffold/scripts/validate-structure.sh \
  --module-path <module-path> --type <type>
```
Capture the results (present, missing, placeholder counts).

Validate root (if --include-root). Run:

bash <plugin-root>/skills/scaffold/scripts/validate-structure.sh --root

Aggregate results. Compute:
- Total modules scanned
- Modules passing vs. failing
- Compliance rate (percentage)
- Most common gaps across all modules
Format output. Based on --format:
- summary: High-level statistics, common gaps, list of failing modules
- detailed: Per-module breakdown (same format as /validate) plus summary
See reference/report-format.md for the complete output specification.

Configuration

The audit skill respects project-level configuration from .claude/settings.json:

Setting	Used For
`modulesDirectory`	Default modules directory if `--modules-dir` not specified
`defaultModuleType`	Fallback module type if `CLAUDE.md` doesn't declare one
`ignoredModules`	Glob patterns for modules to skip
`strictMode`	If true, placeholder-only files are treated as failures

Reference

reference/report-format.md — Complete specification of the audit output format

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: alexnodeland-principled-docs-auditdescription: Docs Audit — Monorepo-Wide Documentation Audit---# Docs Audit — Monorepo-Wide Documentation AuditAudit documentation health across all modules in the monorepo and produce an aggregate compliance report.## Command```/docs-audit [--modules-dir <path>] [--format summary|detailed] [--include-root]```## Arguments| Argument | Required | Description || ---------------------- | -------- | ---------------------------------------------------------------------------- || `--modules-dir <path>` | No | Root directory containing modules (default: `packages` or value from config) || `--format` | No | Output format: `summary` (default) or `detailed` || `--include-root` | No | Also validate the repo-level `docs/` structure |## Workflow1. **Parse arguments.** Extract options from `$ARGUMENTS`. Use defaults from project configuration where not specified.2. **Discover modules.** Find all subdirectories under the modules directory that appear to be modules (contain a `docs/` directory, `README.md`, or `CLAUDE.md`). - Filter out modules matching `ignoredModules` glob patterns from project config.3. **Determine module types.** For each discovered module: - Read the module's `CLAUDE.md` and look for the `## Module Type` section - If not found, use `defaultModuleType` from project config - If neither available, report the module as "unknown type" and skip validation4. **Validate each module.** For each module with a known type, run the structural validation: ```bash bash <plugin-root>/skills/scaffold/scripts/validate-structure.sh \ --module-path <module-path> --type <type> ``` Capture the results (present, missing, placeholder counts).5. **Validate root (if `--include-root`).** Run: ```bash bash <plugin-root>/skills/scaffold/scripts/validate-structure.sh --root ```6. **Aggregate results.** Compute: - Total modules scanned - Modules passing vs. failing - Compliance rate (percentage) - Most common gaps across all modules7. **Format output.** Based on `--format`: - **summary:** High-level statistics, common gaps, list of failing modules - **detailed:** Per-module breakdown (same format as `/validate`) plus summary See `reference/report-format.md` for the complete output specification.## ConfigurationThe audit skill respects project-level configuration from `.claude/settings.json`:| Setting | Used For || ------------------- | ---------------------------------------------------------- || `modulesDirectory` | Default modules directory if `--modules-dir` not specified || `defaultModuleType` | Fallback module type if `CLAUDE.md` doesn't declare one || `ignoredModules` | Glob patterns for modules to skip || `strictMode` | If true, placeholder-only files are treated as failures |## Reference- `reference/report-format.md` — Complete specification of the audit output format---> Converted and distributed by [TomeVault](https://tomevault.io/claim/alexnodeland) — claim your Tome and manage your conversions.

Frequently asked questions

Alexnodeland Principled Docs Audit