act-on-doc-alignment

Apply recommended fixes from a doc alignment audit report to documentation files.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/AlexCMarty/CUNYAutoLogin --skill act-on-doc-alignment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: act-on-doc-alignment
Source: https://github.com/AlexCMarty/CUNYAutoLogin/tree/main/.claude/skills/act-on-doc-alignment
Command: npx skills add https://github.com/AlexCMarty/CUNYAutoLogin --skill act-on-doc-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After running a doc alignment audit, you are left with a list of recommended fixes for outdated content, incorrect references, and contradictory information across your documentation files. Manually applying each of these fixes is tedious, error-prone, and takes time away from higher-priority work.

Core Features & Use Cases

  • Automated Fix Application: Parses doc-alignment reports (default doc-alignment-report.md) to extract patch queues and contradiction fixes, then applies them directly to the target doc files.
  • Safe, Scoped Edits: Only modifies non-executable documentation files (Markdown, plain text, inline doc comments in non-code configs) and never touches source code, build configs, or runtime manifests.
  • Validation & Error Handling: Checks for conflicting patches, skips already resolved fixes, and flags unresolvable changes that require human input to avoid incorrect edits.
  • Use Case: For example, after auditing your project's README and CONTRIBUTING files for outdated dependency paths and incorrect setup instructions, use this skill to automatically apply all recommended fixes without manually editing each file.

Quick Start

Use the act-on-doc-alignment skill to apply all fixes from the doc-alignment-report.md file in your current repository to the relevant documentation files.

Frequently Asked Questions about act-on-doc-alignment

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

FAQPage Schema
How do I automatically apply fixes from a documentation audit report?

To apply documentation audit fixes automatically, you parse patch queues from a doc alignment report and apply them directly to target files. This Skill extracts recommended fixes and patches outdated content without manual editing.

What are documentation alignment fixes and when do I need to patch them?

Documentation alignment fixes resolve outdated content, incorrect references, and contradictory information across project files. You patch them after running a doc audit to ensure your Markdown and plain text files reflect accurate project information.

Can I use this to modify source code or build configuration files?

No, you cannot use this to modify source code or build configurations. It scopes edits exclusively to non-executable documentation files like Markdown, plain text, and inline comments in non-code configs to ensure safe documentation updates.

How do I handle conflicting patches when updating Markdown documentation?

To handle conflicting patches when updating Markdown documentation, you validate patch queue entries and skip already resolved items. The system flags unresolvable fixes that require human intervention to avoid incorrect edits and contradictions.

What is the best way to resolve outdated references in README and CONTRIBUTING files?

The best way to resolve outdated references in README and CONTRIBUTING files is to automate the application of recommended fixes generated from a doc alignment audit, ensuring accurate updates without manually editing each file.

What happens to unresolvable fixes flagged during the doc patching process?

Unresolvable fixes flagged during the doc patching process require human intervention. The system identifies these changes, skips them to avoid conflicting edits, and leaves them for manual review to ensure safe documentation updates.