doc-maintenance

Review top-level documentation against recent code changes and create a PR.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/ulle73/paperclip --skill doc-maintenance-ulle73
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-maintenance
Source: https://github.com/ulle73/paperclip/tree/main/.agents/skills/doc-maintenance
Command: npx skills add https://github.com/ulle73/paperclip --skill doc-maintenance-ulle73

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of keeping top-level documentation (README, SPEC, PRODUCT) up to date with recent code changes, reducing manual review time and improving accuracy.

Core Features & Use Cases

  • Automated Documentation Review: Compares documentation against recent code commits to detect missing or outdated information.
  • Branch and PR Creation: Automatically creates a branch and a Pull Request with minimal edits to fix any discrepancies.
  • Use Case: Use this Skill after major feature merges or on a periodic schedule to ensure your documentation accurately reflects your product.

Quick Start

Run the doc-maintenance skill to automatically review and update your documentation.

Frequently Asked Questions about doc-maintenance

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

FAQPage Schema
How do I automate documentation updates after new code commits?▼

Automated documentation updates compare recent code commits against existing files to identify missing features and outdated information. The process automatically proposes minimal fixes to resolve discrepancies, ensuring top-level documentation accurately reflects recent product changes without manual review.

How do I automatically create a pull request for README fixes?▼

Automated documentation review creates a dedicated branch and submits a pull request containing minimal edits to fix documentation discrepancies. This workflow automatically updates top-level files like README and SPEC to align with recent code changes, ensuring accuracy without manual intervention.

What is the best way to keep top-level project documentation accurate with recent code changes?▼

Keeping top-level documentation accurate requires comparing file contents against recent code changes to detect missing or outdated information. Automated review identifies discrepancies in top-level files and proposes minimal fixes, ensuring documentation aligns with the product without manual review.

Do I need Git to run automated document maintenance checks?▼

Git is required to run automated document maintenance checks. The process uses Git to compare recent code commits against existing documentation, identify missing features, propose minimal fixes, and create a dedicated branch with a pull request for the updates.

Can I use YAML and Markdown for automated documentation review configuration?▼

Automated documentation review uses YAML and Markdown for configuration. The process evaluates top-level Markdown files like README and SPEC against recent code commits, identifying missing features and automatically proposing minimal fixes to update the documentation.

When should I run automated documentation accuracy checks?▼

Automated documentation accuracy checks should be run after major feature merges or on a periodic schedule. This timing ensures top-level documentation is continuously reviewed against recent code changes, identifying missing features and outdated information to maintain product accuracy.