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-code

Installs 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

More from warpdotdev/oz-skills

All 9
1geminilight avatarmindosgeminilight/mindosMindOS: local knowledge assistant & shared KB. Keeps decisions, notes, SOPs, debugging lessons, research findings, preferences across sessions/agents. Core: sav195skills.sh installs
2jwilger avatartddjwilger/agent-skillsUse this skill whenever the user wants to write code using TDD, test-driven development, or test-first methodology. Triggers on: "/tdd", "let's do TDD", "write 195skills.sh installs
3levnikolaevich avatarln-910-community-engagementlevnikolaevich/claude-code-skillsAnalyzes community health and delegates engagement tasks. Use when managing GitHub issues, discussions, and announcements.194skills.sh installs
4aiskillstore avatarskill-installeraiskillstore/marketplaceInstall Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill191skills.sh installs
5personamanagmentlayer avatarcicd-expertpersonamanagmentlayer/pclExpert-level CI/CD with GitHub Actions, Jenkins, deployment pipelines, and automation190skills.sh installs
6nexu-io avatarhtml-ppt-obsidian-claude-gradientnexu-io/open-designGitHub 暗紫渐变 deck — GitHub-dark186skills.sh installs