Does it support standard changelog formats?

Yes, it follows the 'Keep a Changelog' methodology, automatically categorizing changes into Added, Changed, Deprecated, Removed, Fixed, and Security sections based on git history.

What is the Documentation Maintenance skill?

It is a specialized capability for Claude Code designed to audit, update, and optimize project documentation like READMEs, CHANGELOGs, and CLAUDE.md based on recent code changes.

How does it identify what needs updating?

The skill analyzes git logs and compares the modification timestamps of source code against documentation files to identify 'stale' documentation or undocumented feature additions.

How does it optimize documentation for AI agents?

The skill refines CLAUDE.md files using imperative language, explicit file paths, and concrete examples to ensure AI coding assistants follow project-specific conventions accurately.

Documentation Maintenance

Name: Documentation Maintenance
Author: jeffrigby

byjeffrigby

•

Content Management

Keeps project documentation current and optimized for AI coding agents by synchronizing code changes with technical Markdown files.

The Documentation Maintenance skill is a comprehensive methodology for Claude Code designed to bridge the gap between evolving source code and project documentation. It automates the analysis of git history to identify undocumented changes, updates README and CHANGELOG files, and specifically optimizes CLAUDE.md to improve the effectiveness of AI coding agents. By auditing documentation freshness and ensuring cross-document consistency, this skill helps maintain a high-quality knowledge base that serves both human developers and AI assistants with accurate, actionable project context.

Key Features

01AI-specific optimization for CLAUDE.md to improve agent instruction following

025 GitHub stars

03Automated git history analysis to detect undocumented features and API changes

04Standardized CHANGELOG management following 'Keep a Changelog' formatting

05Freshness monitoring comparing code modification dates against documentation updates

06Cross-document consistency auditing to resolve contradictions between files

Use Cases

01Auditing a legacy codebase to identify stale instructions, broken links, and outdated usage examples

02Synchronizing project documentation after a significant feature release or codebase refactor

03Optimizing a repository's CLAUDE.md file to help AI agents better understand local coding conventions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jeffrigby/somepulp-agents docs-maintenance

For use in Claude.ai and ChatGPT

Download Skill