How does the skill identify which documents need updating?

The skill analyzes your git history, checking for staged and unstaged changes or recent commits, and maps the type of change (like a new CLI command) to a predefined documentation map.

What specific documentation files are supported?

It is designed to manage README.md, AGENTS.md, CLAUDE.md, SKILL.md, and various development guides and manifest files.

Can it help with architectural documentation?

Yes, it specifically identifies changes in services, layers, or dependencies and prompts updates for the architectural sections within AGENTS.md.

Does it handle version number synchronization?

Yes, it ensures that version numbers remain consistent across the .csproj file, plugin.json, and marketplace.json to prevent deployment errors.

Does this work with any Git repository?

While the logic is general, this specific skill is optimized for the AzurePipelinesTool repository structure and its specific documentation hierarchy.

Update Documentation

Name: Update Documentation
Author: lbussell

bylbussell

•

Aprendizaje y Documentación

Synchronizes project documentation with recent code changes by identifying modified files and updating relevant guides, manifests, and version files.

The Update Documentation skill automates the critical task of maintaining accurate project records following code modifications. By intelligently analyzing git history and diffs, it identifies exactly what has changed—be it a new CLI command, a modified flag, or an architectural shift—and maps those changes to the specific documentation files that require revision. This ensures that READMEs, developer guides (AGENTS.md), and plugin manifests remain perfectly consistent with the codebase, specifically optimized for the AzurePipelinesTool ecosystem to prevent documentation rot and versioning mismatches.

Características Principales

01Comprehensive mapping of code modifications to documentation requirements

02Automated git diff and history analysis to pinpoint code changes

03Verification checks for command lists and configuration consistency

04Multi-file version synchronization across project and manifest files

05Maintenance of architectural descriptions and developer-facing guides

062 GitHub stars

Casos de Uso

01Synchronizing version numbers across .csproj and plugin metadata files

02Updating README and SKILL.md files after adding new CLI commands or flags

03Maintaining architectural consistency in AGENTS.md after service or layer changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lbussell/azurepipelinestool update-documentation

For use in Claude.ai and ChatGPT

Download Skill