updatedocs

Update Markdown documentation to reflect code, service, and configuration changes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Auto-one-Family/Automation-One --skill updatedocs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: updatedocs
Source: https://github.com/Auto-one-Family/Automation-One/tree/main/.claude/skills/updatedocs
Command: npx skills add https://github.com/Auto-one-Family/Automation-One --skill updatedocs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps project documentation synchronized with code, configuration, and service changes by identifying affected files and performing minimal, pattern-preserving edits so docs never drift from implementation.

Core Features & Use Cases

  • Dependency-driven identification: Match change types (ports, services, agents, endpoints, log paths) against a dependency matrix to produce a precise list of affected docs.
  • Surgical edits: Read each target Markdown file completely, copy existing entry patterns, and modify only the exact lines required without reformatting or changing heading levels.
  • Consistency and reporting: Validate format conventions, preserve tables and headings, and produce a concise report listing every edited file and the single-line change summary.
  • Use Case: When a Docker service port or a new agent is introduced, use this Skill to update .claude reference docs, rules, and skill indexes without rewriting files.

Quick Start

Update documentation to reflect a new Docker service named metrics running on port 9100 and return a one-line summary for each file you edited.

Frequently Asked Questions about updatedocs

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

FAQPage Schema
How do I update repository documentation to reflect code and configuration changes?

Update repository documentation by identifying affected Markdown files through a dependency matrix and applying targeted, pattern-preserving edits. This ensures docs accurately reflect code, service, and configuration changes without restructuring content.

What is the best way to keep project documentation synchronized after adding a new service or port?

Keeping project documentation synchronized involves matching change types like ports, services, and endpoints against a dependency matrix to find affected docs. It then applies surgical edits to modify only exact lines required, preserving existing tables and headings.

How do I identify which Markdown files need updates when endpoints or log paths change?

Identify affected Markdown files by matching specific change types, such as endpoints, agents, skills, or log paths, against a dependency matrix. This produces a precise list of documentation files requiring targeted updates.

Can I update .claude reference docs and skill indexes without rewriting entire files?

Yes, you can update .claude reference docs and skill indexes without rewriting files by reading each target Markdown file completely, copying existing entry patterns, and modifying only the exact lines required to reflect the changes.

Does this documentation update approach preserve existing Markdown formatting and heading levels?

Yes, this approach preserves existing Markdown formatting and heading levels by validating format conventions and performing minimal, surgical edits. It modifies only exact lines required without reformatting content or altering document structure.

What limitations exist when applying surgical edits to repository documentation?

A key limitation is that surgical editing avoids restructuring content or changing heading levels, focusing solely on minimal pattern-preserving modifications. It requires reading each affected file in full to accurately match change types to the dependency matrix.