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.