auto-doc

Analyze git diffs to update README and CHANGELOG entries.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/Xunzi229/skills --skill auto-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-doc
Source: https://github.com/Xunzi229/skills/tree/main/auto-doc
Command: npx skills add https://github.com/Xunzi229/skills --skill auto-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

在代码提交或修改后,维护文档(README.md 和 CHANGELOG.md)通常是重复且容易遗漏的工作。该 Skill 自动识别代码、配置或接口变更,并将关键信息同步到项目文档,减少人工维护负担并保证发布记录的一致性。

Core Features & Use Cases

  • 变更提取:从 git diff 或工作区修改中提取新增功能、修复或接口变动的核心要点。
  • README 同步:当配置项或对外接口变更时,自动更新 README 中的配置说明或示例。
  • CHANGELOG 记录:按照 Keep a Changelog 规范在 Unreleased 或当前版本下追加精简条目,并建议 SemVer 版本变更。
  • Use Case:开发者在完成功能并提交代码后,让该 Skill 自动在 CHANGELOG.md 添加 [Added]/[Fixed] 条目并检查 README 示例是否需更新。

Quick Start

使用本 Skill 根据 git diff 或已修改的文件自动追加简短条目到 CHANGELOG.md 的 Unreleased 区并同步 README.md 中受影响的配置或示例。

Frequently Asked Questions about auto-doc

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

FAQPage Schema
How do I automatically update README and CHANGELOG from git diff?

To automatically update README and CHANGELOG from git diff, this Skill analyzes workspace changes to extract code and API modifications, then synchronizes documentation entries without manual intervention. It identifies non-documentation code changes and appends concise records to the appropriate markdown files.

How does auto-generating a changelog from code changes maintain markdown syntax integrity?

Auto-generating a changelog from code changes maintains markdown syntax integrity by strictly following Keep a Changelog conventions. The Skill appends precise entries to the Unreleased section and ensures the existing markdown structure remains valid while suggesting semantic version adjustments.

When do I need to synchronize README examples before a release?

You need to synchronize README examples before a release when configuration items or external APIs have been modified. During commit staging or pre-release preparation, the Skill detects these specific changes and updates the affected configuration descriptions and usage examples.

Can I use semantic versioning recommendations without manually checking git diffs?

Yes, you can use semantic versioning recommendations without manually checking git diffs. The Skill analyzes extracted code modifications and automatically recommends SemVer version changes based on the significance of the added features or fixes it detects in your workspace.

What are the limitations of automatically extracting code modifications for documentation?

A key limitation of automatically extracting code modifications for documentation is that the Skill avoids inventing changes. It only records verified modifications from the git diff, ensuring documentation accuracy but requiring actual staged code changes to generate meaningful README and CHANGELOG updates.