- Home
- Skills
- Technical Documentation
- Technical Documentation Drift Fix
Technical Documentation Drift Fix
Detect where docs diverged from the code, prioritise the dangerous drift, and close it in order.
$5
Works with the AI Agents you already use
Technical Documentation Drift Fix
Example session with this skill installed
Apply the skill to a small test input and produce its core output. The script compares headings and code-block counts between two markdown files only; it does not read code or config, so drift inside a section still needs the manual comparison in the protocol.
- Read your context and instructions
- Compiled the technical documentation drift
A team inherited 86 doc pages for an internal platform, and new hires kept failing the same setup step. The inventory showed 31 pages with no owner and 19 not updated in over a year. Three-source comparison found the real problem: a default port had changed two releases earlier, and the setup page still showed the old port, while a second page described a removed flag. Those two pages were repaired first, verified against the current configuration, and dated. Support questions about setup fell from nine in the previous month to one in the next, and the remaining drift was scheduled by harm order over four weeks instead of a single doomed rewrite. The maintenance rule, owner plus release trigger, was the part that prevented recurrence.
Script demo (verified): running python3 scripts/doc_drift.py on a test pair printed no removed or added headings, 2 unchanged headings, and code blocks 1 -> 2.
This is a worked example produced by applying the skill, not a claim about a live customer outcome.
Connects securely to your tools. The creator never sees your data.
About this skill
A workflow for documentation that has drifted from the shipped system: detect drift by comparing docs against code, configuration, and behaviour, rank it by harm if followed, and repair the worst drift first. The skill provides a step-by-step protocol with decision points, a decision table, a fill-in template, a checklist, and a scoring rubric, plus a runnable script (doc_drift.py) that compares headings and code blocks between two markdown files and reports added, removed, and changed sections. It focuses on finding the bottleneck first and fixing in an order backed by evidence, rather than applying generic advice.
It detects drift it can compare; undocumented behaviour and tribal knowledge need a human to surface. It does not rewrite docs automatically.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 23 days ago