# Docs Audit

> Audit repository documentation, README, examples, installation steps, onboarding flow, API docs, and contribution docs. Use when the user asks whether docs are clear, complete, current, or ready for a public repo.

- **Type:** Skill
- **Install:** `agentstack add skill-stark-ai-de-agent-skills-docs-audit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [stark-ai-de](https://agentstack.voostack.com/s/stark-ai-de)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [stark-ai-de](https://github.com/stark-ai-de)
- **Source:** https://github.com/stark-ai-de/agent-skills/tree/main/incubator/skills/repo-maintenance/docs-audit
- **Website:** https://stark-ai-de.github.io/agent-skills/

## Install

```sh
agentstack add skill-stark-ai-de-agent-skills-docs-audit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Docs Audit

## Goal

Find documentation gaps that block users, contributors, maintainers, or agents from understanding, installing, validating, and safely changing the repository.

## When to use

- The user asks whether docs are clear, complete, current, or public-ready.
- README, examples, onboarding, API docs, or contribution docs need review.
- Documentation promises may have drifted from actual code and commands.

## When not to use

- The user asks for a full repo maintenance audit; use `repo-health-audit`.
- The user wants release notes; use `release-manager`.
- The user wants prose editing only and no repo evidence check.

## Inputs to inspect

- README, docs, examples, changelog, contributing guide, security policy, and license.
- Package scripts, CLI help, config examples, and source files that docs mention.
- Internal links, install commands, screenshots, and generated docs.

## Review rubric

Check audience fit, first-run path, command accuracy, link integrity, examples, maintenance docs, public safety, and agent usability. Read `references/docs-rubric.md` for details.

## Workflow

1. Identify the intended audiences and main user journeys.
2. Compare README promises with actual files and commands.
3. Verify install, validate, and usage examples where practical.
4. Check internal links and stale references.
5. Separate user-facing docs gaps from maintainer-only improvements.
6. Produce a prioritized docs gap list.

## Safety rules

- Do not publish docs, rewrite policy, or change public support commitments without approval.
- Do not include private URLs, internal hostnames, customer details, or credentials in examples.
- Mark commands as unverified when they were not run.

## References

Read only when needed:

- `references/docs-rubric.md`

## Scripts

No bundled scripts.

## Output format

Return:

1. Summary
2. Blocking docs gaps
3. Confusing or stale sections
4. Missing examples
5. Suggested rewrite or new docs
6. Recommended next action

## Failure modes

- If commands cannot run, report them as unverified instead of broken.
- If the product goal is unclear, infer it from README and mark the inference.
- If docs are generated, identify the source file before editing output.

## Completion criteria

- Findings reference docs paths and, when relevant, source-of-truth code.
- Recommended changes are prioritized by user impact.
- The next docs action is specific.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [stark-ai-de](https://github.com/stark-ai-de)
- **Source:** [stark-ai-de/agent-skills](https://github.com/stark-ai-de/agent-skills)
- **License:** Apache-2.0
- **Homepage:** https://stark-ai-de.github.io/agent-skills/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-stark-ai-de-agent-skills-docs-audit
- Seller: https://agentstack.voostack.com/s/stark-ai-de
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.