Nightly Docs Sweep
Run a documentation sweep for a codebase. Use this when the user asks for a nightly docs sweep, overnight docs sweep, documentation drift audit, README/setup/API docs refresh, docs sync after implementation changes, or a reviewable pull request that makes docs match the current code.
Install
$ agentstack add skill-leek-agent-skills-nightly-docs-sweep ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Nightly Docs Sweep
Goal
Make repository documentation match the current implementation, then leave a reviewable change set or pull request.
Loop Prompt
Whenever a documentation pass is needed, review the codebase in full and make sure all documentation reflects the current implementation. Update stale documentation, verify the changes, then open a pull request.Stop when documentation matches the current implementation and the docs changes are ready for review.
When To Use
Use this whenever implementation changes may have left READMEs, setup guides, API references, examples, architecture notes, comments, or runbooks behind.
Workflow
- Review implementation changes since the last documentation pass.
- Compare the repository's documentation with the code, configuration, commands, and behavior that currently ship.
- Update only stale or missing material. Do not rewrite accurate documentation just to create activity.
- Verify commands, links, examples, configuration names, API shapes, and setup steps against the current repository.
- Run the relevant checks available in the project, such as documentation tests, link checks, type checks, unit tests, or linting.
- Summarize the documentation drift found, the files changed, and the verification performed.
- If the user asked for a PR and the environment supports it, open a pull request with a clear title and body.
Report
End with:
- Documentation areas checked.
- Stale or missing docs found.
- Files updated.
- Verification commands run and their results.
- Remaining gaps or blockers.
- Pull request link, if one was opened.
Guardrails
- Keep scope tied to real implementation behavior.
- Preserve accurate documentation and user-authored wording where practical.
- Do not invent behavior that is not backed by code, configuration, tests, or project docs.
- If the repository is too large for a full sweep in one pass, prioritize changed or high-traffic docs first and clearly state the remaining scope.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: leek
- Source: leek/agent-skills
- License: MIT
- Homepage: https://skills.sh/leek/agent-skills
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.