plan-docs-sync SKILL.md skillA

plan-docs-sync from kensaurus/cursor-kenji is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kensaurus/cursor-kenji/plan-docs-sync@git:20260923.68c095e

Pins git:20260923.68c095e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kensaurus/cursor-kenji
Path
skills/plan-docs-sync/SKILL.md
Versions recorded
5
Latest version
git:20260923.68c095e, committed Sep 23, 2026
First version recorded
Aug 17, 2026
Size
5,105 bytes
Repository stars
9
License
MIT

Plan-only audit of documentation against actual code behavior. Use when "docs drift", "sync docs with code", "audit documentation", "stale README", "onboarding docs broken", "phantom docs", or "docs out of date". Decisions/ADRs → docs-adr.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Docs Drift Audit + Sync Plan

**Degree of freedom: MIXED** — inventory globs are exact; drift judgment
is high. Stay **plan-only**. No rewrites until approved.

**Role:** Senior engineer + technical writer.

**Task:** Audit all documentation against what the code **actually does**, find every drift,
plan corrections. README, CONTRIBUTING, setup/onboarding, API docs, JSDoc/docstrings,
architecture notes, `.env.example`, CLI `--help`, changelogs. **Audit & plan only.**

## This skill vs neighbors

| Skill | Does |
|-------|------|
| **plan-docs-sync** (this) | Plan doc corrections from code truth |
| `docs-writer` | Write/improve docs (execution) |
| `workflow-housekeep` | README refresh as part of housekeeping |
| `plan-stub-checker` | Stubs/dead UI — often surfaces phantom docs |

**Loop position:** run **last** in the six-skill plan loop. See `docs/PLAN-LOOPS.md`.

## How to reason (every plan item)

1. **Propose** — correction that makes the doc match code truth
2. **Risk** — onboard fail, phantom API, or invented behavior if left stale
3. **Keep-working** — claims already backed by path:line
4. **Phase** — factual drift first; wording last (do not execute)

## Worked example
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kensaurus/cursor-kenji/plan-docs-sync@sha256:35ae3a9d769769c1

The line at the top of this page pins the label git:20260923.68c095e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vgyyi537qinnz2b6.svg)](https://markdownregistry.com/a/art_vgyyi537qinnz2b6)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 17, 2026 and Sep 23, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20260923.68c095e latest2026-09-23 68c095e 5,105 BA view · diff
git:20260923.cf348bd2026-09-23 cf348bd 5,175 BA view · diff
git:20260819.170df672026-08-19 170df67 4,978 BA view · diff
git:20260818.67231002026-08-18 6723100 3,527 BA view · diff
git:20260817.5b93a212026-08-17 5b93a21 3,491 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5105 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kensaurus/cursor-kenji · 9 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vgyyi537qinnz2b6
GET https://markdownregistry.com/api/v1/resolve?ref=kensaurus/cursor-kenji/plan-docs-sync
GET https://markdownregistry.com/api/v1/blob/35ae3a9d769769c186288e852634c722313200d6ca48ff08a77b2dabbeb33ddb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kensaurus/cursor-kenji

approved-plan-execution Cursor rule
kensaurus/cursor-kenji · .cursor/rules/approved-plan-execution.mdc · Guard execution of an approved plan or burndown: forbid reward hacking and feature deletion; require checkpoints…
git:20260923.68c095e · audit A · 9 stars
skill-workflows Cursor rule
kensaurus/cursor-kenji · .cursor/rules/skill-workflows.mdc · Skill routing where a name alone misleads: multi-phase requests, closure modes (complete-everything, burndown-full)…
git:20261001.3fce9fb · audit A · 9 stars
verification-before-completion Cursor rule
kensaurus/cursor-kenji · .cursor/rules/verification-before-completion.mdc · Require fresh, scope-appropriate evidence before any completion claim. Distinguishes implemented, locally verified…
git:20260923.cf348bd · audit A · 9 stars
AGENTS.md AGENTS.md file
kensaurus/cursor-kenji · AGENTS.md
git:20261001.3fce9fb · audit A · 9 stars
llms.txt llms.txt file
kensaurus/cursor-kenji · llms.txt
git:20261009.3771283 · audit A · 9 stars
babysit SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/babysit/SKILL.md · Keep an already-open PR merge-ready: triage comments, resolve clear conflicts, fix CI. Do not merge. Dirty tree →…
git:20260923.68c095e · audit A · 9 stars
canvas SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/canvas/SKILL.md · Create a live React canvas beside chat for standalone analytical artifacts that benefit from visual layout…
git:20260923.cf348bd · audit A · 9 stars
create-hook SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/create-hook/SKILL.md · Create Cursor hooks. Use to create a hook, write hooks.json, add hook scripts, or automate behavior around agent events.
git:20260923.cf348bd · audit A · 9 stars
create-rule SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/create-rule/SKILL.md · Create Cursor rules for persistent AI guidance. Use when user wants to create a rule, add coding standards, project…
git:20260923.cf348bd · audit A · 9 stars
create-skill SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/create-skill/SKILL.md · Guide users through creating effective Agent Skills for Cursor. Use when user wants to create, write, update, or debug…
git:20261001.3fce9fb · audit A · 9 stars
create-subagent SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/create-subagent/SKILL.md · Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up…
git:20260923.68c095e · audit A · 9 stars
migrate-to-skills SKILL.md skill
kensaurus/cursor-kenji · skills-cursor/migrate-to-skills/SKILL.md · Convert 'Applied intelligently' Cursor rules (.cursor/rules/*.mdc) and slash commands (.cursor/commands/*.md) to Agent…
git:20260923.68c095e · audit A · 9 stars

Every file in kensaurus/cursor-kenji

Other files named plan-docs-sync

plan-docs-sync SKILL.md skill
kensaurus/skills · skills/plan-docs-sync/SKILL.md · Plan-only audit of documentation against actual code behavior. Use when "docs drift", "sync docs with code", "audit…
git:20260923.68c095e · audit A · 9 stars

Browse by kind, by grade A, or by owner.