
Docs Update
This handles the tedious work of keeping docs in sync when your code changes. It scans recent commits, filters out internal refactoring and minor fixes to focus on user-facing changes, then updates your documentation to match. Works across different doc platforms like Mintlify, Docusaurus, and GitBook, and it's smart enough to match your existing writing style and structure. The workflow is thoughtful: it analyzes context before making changes, stays conservative about what needs updating, and creates PRs with proper commit references. You can run it in testing mode to preview changes or let it execute automatically. Honest take: the style-matching and significance filtering show this was built by someone who's dealt with stale docs.
- skills.sh installs
- 206
- GitHub stars
- 824
- last updated
- Aug 21, 2026
Install
$ npx -y skills add warpdotdev/oz-skills --skill docs-update --agent claude-codeInstalls into .claude/skills of the current project.
Files
Documentation Bot
Automatically review code changes and update user-facing documentation to keep it synchronized with the codebase. Works across documentation platforms (Mintlify, Docusaurus, GitBook, Fumadocs, etc.) and supports both monorepo and multi-repo setups.
Workflow
1. Identify Significant Code Changes
Determine which commits need documentation updates:
- Find the default branch
- Get recent commits (default: last 24 hours, or accept user-specified timeframe)
- Examine each commit's changes to understand what was modified
Filter for significant changes:
- New features or capabilities
- API changes (new endpoints, parameters, return values)
- Breaking changes
- New configuration options
- New CLI commands or flags
- Changes to user-facing behavior
Skip documentation for:
- Internal refactoring
- Test-only changes
- Minor bug fixes
- Typo corrections in code
- Performance optimizations without user impact
Be conservative: quality over quantity. When in doubt about significance, skip the update.
2. Analyze Documentation Context
Sponsors
Details
- Repository
- github.com/warpdotdev/oz-skills
- Categories
- Git & Pull Requests, Documentation, Code Review & Quality
- First seen
- Jun 3, 2026