skills.rest
windyroad
windyroadOFFICIAL
Explore all skills by this author →
WebsiteGitHub

wr-itil:reconcile-readme

Detect drift between README and ticket state, then apply narrative-preserving edits.

4|1|Updated Apr 7, 2026
Search Tags:#automation#readme#governance#drift#reconcile#itil
One-click install
npx skills add https://github.com/windyroad/agent-plugins --skill wr-itil-reconcile-readme
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wr-itil:reconcile-readme
Source: https://github.com/windyroad/agent-plugins/tree/main/packages/itil/skills/reconcile-readme
Command: npx skills add https://github.com/windyroad/agent-plugins --skill wr-itil-reconcile-readme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconciles drift between docs/problems/README.md and the on-disk ticket inventory, ensuring narrative content is preserved during automated corrections.

Core Features & Use Cases

  • Automates detection of drift between problem READMEs and ticket state.
  • Applies agent-applied-edits that preserve the long "Last reviewed" prose and closed-section narrative.
  • Works as a preflight guard in manage-problem and work-problems flows, as well as direct user invocations.

Quick Start

Run claude /wr-itil:reconcile-readme to reconcile the README against filesystem drift.

Frequently Asked Questions about wr-itil:reconcile-readme

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

FAQPage Schema
How do I automate README drift detection and reconciliation?▼

README drift detection and reconciliation is automated by running a drift-detection workflow that compares the README against on-disk ticket state and applies agent-applied-edits to fix discrepancies without overwriting curated prose.

Why does my README content get overwritten during automated corrections?▼

Automated corrections can overwrite prose because standard edits lack narrative awareness. Reconcile-readme applies agent-applied-edits specifically designed to preserve long 'Last reviewed' prose and closed-section narrative during drift fixes.

What is README drift in ITIL governance workflows?▼

README drift in ITIL governance is the inconsistency between documented problem descriptions and actual on-disk ticket state. Detecting and reconciling this drift ensures documentation accurately reflects the current ticket inventory.

Can I use reconcile-readme as a preflight guard for manage-problem flows?▼

Yes, reconcile-readme works as a preflight guard in manage-problem and work-problems flows. It runs the drift-detection workflow before executing corrections to ensure the README matches the filesystem state.

Does reconcile-readme require any external dependencies to run?▼

Reconcile-readme has no external dependencies. It relies entirely on the internal reconcile-readme.sh shell script for drift detection and the native Edit tool for applying narrative-preserving corrections.

What are the limitations of automated README drift correction?▼

Automated README drift correction is limited to fixing discrepancies between the README and on-disk ticket state. It intentionally avoids modifying curated narrative content, meaning manual intervention is still required for substantive prose updates.

Related Skills

Explore More Software Engineering Skills→
josemlopezjosemlopez
8

tm-drift

Compare current threat models against a baseline and generate drift-report.md.

Community
Intermediate
windyroadwindyroad
4

wr-itil:work-problem

Select the highest-WSJF ticket and delegate its workflow to manage-problem.

Official
Advanced
ahostbrahostbr

ls-librarian

Synchronize architecture docs, skill catalogs, and memory with the codebase.

Community
Advanced
manuelbrandner85manuelbrandner85

dart-fix-runtime-errors

Resolve Dart static analysis errors and runtime type mismatches.

Community
Intermediate