doc-updater

Route code changes to owning docs and update them in the same commit.

Updated May 14, 2026
One-click install
npx skills add https://github.com/jacob-balslev/skills --skill doc-updater-jacob-balslev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-updater
Source: https://github.com/jacob-balslev/skills/tree/main/skills/knowledge-organization/doc-updater
Command: npx skills add https://github.com/jacob-balslev/skills --skill doc-updater-jacob-balslev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation drift between code and its docs is costly and error-prone; the doc-updater enforces the same-commit, ownership-based doc updates.

Core Features & Use Cases

  • Identify changed files in a commit
  • Route to owning docs via a routing table
  • Update owning docs with a dated change marker
  • Verify changes landed and report progress
  • Perform a stale-reference sweep for renames/deletes

Quick Start

Run the 5-step doc-sync workflow on a changed commit to route and update the owning documentation in the same change.

Frequently Asked Questions about doc-updater

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep documentation in sync with code changes in the same commit?

To keep documentation in sync with code changes in the same commit, you can use a 5-step doc-sync workflow that enumerates file diffs, routes changes to owning docs, applies updates with dated markers, and verifies the results in-commit.

What is documentation drift and how do I prevent it when modifying code?

Documentation drift happens when code changes leave co-located docs outdated. Prevent drift by binding code edits to their canonical owning documentation and enforcing ownership-based updates within the same commit.

How do I find and fix stale references in documentation after renaming or deleting code?

To fix stale references after renaming or deleting code, run a stale-reference sweep that detects outdated mentions and verifies all documentation updates landed correctly before reporting completion.

Can I update documentation for multiple programming languages in a single repository?

Yes, you can update documentation for multiple programming languages in a single repository. The workflow handles edits across languages and tooling by routing diffs to the canonical owning docs for each changed file.

What is the best way to automate documentation ownership routing for code commits?

The best way to automate documentation ownership routing is to use a routing table that maps changed files to their canonical owning docs, ensuring updates are applied and verified with a dated change marker in the same commit.

Related Skills