Skip to content
Skills Library
Programming · Analysis

codex-docs-change-sync

/codex-docs-change-sync

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/map_changes_to_docs.py

What it does and when to use it

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

Original author description

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

How it works

  1. TL;DR
  2. Purpose
  3. Activation
  4. Script Invocation
  5. Script Invocation Discipline
  6. Enhanced Diff Scope
  7. Behavior
  8. Fallback
  9. Reference Files
Original SKILL.md headings · 51 lines, 201 words
SKILL.md preview
---
name: codex-docs-change-sync
description: Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.
load_priority: lazy
---

## TL;DR
Map code changes to affected documentation via `map_changes_to_docs.py`. Report-only by default, no auto-edit. Scope: auto-detect staged -> unstaged -> last commit. Fallback: manual diff inspection.

# Codex Docs Change Sync

## Purpose

Identify documentation that is likely affected by code changes.

## Activation

1. Activate during workflow `docs` steps.
2. Activate on explicit `$codex-docs-change-sync`.

## Script Invocation

- Use `map_changes_to_docs.py` for report-only docs impact mapping.
- See `skills/.system/REGISTRY.md` for full script paths.

## Script Invocation Discipline

1. Always run `--help` before invoking `map_changes_to_docs.py`.
2. Treat the script as a black-box mapper and prefer direct execution over source inspection.
3. Read script source only when customization or bug fixing is required.

## Enhanced Diff Scope

If scope is not specified, use `auto` mode:

1. staged changes
2. unstaged changes
3. last commit

Report which scope was selected.

## Behavior

1. Run script and parse JSON output.
2. Report changed files and candidate docs with reason/confidence.
3. Keep MVP in report-only mode; do not auto-edit docs unless user requests it.

## Fallback

If script cannot run, inspect diffs manually and report likely docs:
`docs/`, `README.md`, `CHANGELOG.md`, and module-specific docs.

## Reference Files

- `references/docs-sync-spec.md`: script behavior, output format, and fallback protocol.
Files in this package (5)
  • SKILL.md 2 KB
  • agents/openai.yaml 1 KB
  • references/docs-sync-spec.md 1 KB
  • references/mapping-rules.md 1 KB
  • scripts/map_changes_to_docs.py 17 KB

Versions

The database has no other skills named codex-docs-change-sync.

Database snapshot: 13.11.2026 · package version ae3dad83d1b6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100docs-updater
    Provides automated documentation updates by analyzing git changes between the current branch and the last release tag. Performs git diff analysis to identify modifications, then updates README.md, CHANGELOG.md following Keep a Changelog standard, and discovers documentation…
  • 100docs-update-from-diff
    Review local code changes with git diff and update the official docs under docs/ to match. Use when the user asks to document current uncommitted work, sync docs with local changes, update docs after a feature or refactor, or when phrases like "git diff", "local changes",…
  • 100docs-sync
    Use when the user asks to update documentation after code or configuration changes, audit documentation drift, or prepare README, API, runbook, or release docs. Changes only affected documentation and verifies examples, links, contracts, and operational steps against source code.
  • 95update-docs-on-code-change
    Automatically update README.md and documentation files when application code changes require documentation updates Triggers on: **/*.{md,js,mjs,cjs,ts,tsx,jsx,py,java,cs,go,rb,php,rs,cpp,c,h,hpp}
  • 100docs-updater
    Detect documentation drift and patch affected docs (candidate survey, git hook, range cursor, or detect JSON). Use in conversation when the user asks to sync or update docs after code changes. Also the loop entry skill for documentation drift automation. Interactive default is…
  • 100docsync
    Use when documentation may be stale after a code change; when finishing a feature, fix, or pull request; or when asked to sync docs, review stale docs, check which document sections need updating, or run docsync. Also use when a repo has a docsync.yml mapping.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.