doc-sync SKILL.md skillA

doc-sync from univers42/claude-deal-with-the-devil is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add univers42/claude-deal-with-the-devil/doc-sync@git:20260930.06ed519

Pins git:20260930.06ed519 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
univers42/claude-deal-with-the-devil
Path
skills/doc-sync/SKILL.md
Versions recorded
5
Latest version
git:20260930.06ed519, committed Sep 30, 2026
First version recorded
Sep 30, 2026
Size
3,769 bytes
Repository stars
4
License
none declared

Find the documentation a change just made false and fix exactly that, examples copied from a passing run. Use when a flag was renamed, a path moved, a default changed, a command was removed, or a README example no longer matches what the code prints. Auto-triggers on: "update the docs", "are the docs current", "the README is out of date", "document this change", "the docs are stale".

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

# Doc sync

Documentation does not rot gradually. It becomes false at a specific commit, and then
stays false until someone notices — usually a new person, who trusts it, and loses an
afternoon.

This is the pass that runs *after* a change: find what the change falsified, and fix
exactly that. The `documenter` agent writes docs from scratch; this keeps existing ones
true.

## 1. Find what the change falsified

Start from the diff, not from the docs.

```sh
git diff --name-only <base>..HEAD
```

For every renamed, removed or signature-changed thing, grep the docs for it:

```sh
rg -n '<old-name>|<old-flag>|<old-path>' --glob '*.md' --glob '*.rst'
devil selfcheck  # in a .claude config: names docs claim but that are gone
```

The five that go stale first, in order of how often:

1. **Command examples** — a renamed flag, a changed default, a moved path.
2. **Output samples** — pasted once, never re-run, now showing columns that no longer
   exist.
3. **Config keys** — documented after being renamed.
4. **Cross-references** — a link to a file that moved or a section that was retitled.
5. **Counts and lists** — "the six tools", now seven. This one is invisible and
   constant.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add univers42/claude-deal-with-the-devil/doc-sync@sha256:a91e541a25b8a84e

The line at the top of this page pins the label git:20260930.06ed519, 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_v25kspytiokypqz3.svg)](https://markdownregistry.com/a/art_v25kspytiokypqz3)

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

Versions

The registry has recorded 5 versions of this file, all committed on Sep 30, 2026.

versioncommittedcommitsizeaudit
git:20260930.06ed519 latest2026-09-30 06ed519 3,769 BA view · diff
git:20260930.b857b762026-09-30 b857b76 3,630 BA view · diff
git:20260930.a77cb5e2026-09-30 a77cb5e 3,634 BA view · diff
git:20260930.aa9f9b92026-09-30 aa9f9b9 3,589 BA view · diff
git:20260930.445fa692026-09-30 445fa69 3,593 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 (3769 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

univers42/claude-deal-with-the-devil · 4 stars · license none declared · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_v25kspytiokypqz3
GET https://markdownregistry.com/api/v1/resolve?ref=univers42/claude-deal-with-the-devil/doc-sync
GET https://markdownregistry.com/api/v1/blob/a91e541a25b8a84eee24ae7879d141a2081e9c0eabfb8780c1d92b96e923f140

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 univers42/claude-deal-with-the-devil

AGENTS.md AGENTS.md file
univers42/claude-deal-with-the-devil · AGENTS.md
git:20261002.ea97c77 · audit A · 4 stars
api-convention SKILL.md skill
univers42/claude-deal-with-the-devil · skills/api-convention/SKILL.md · REST API conventions: resource-oriented and versioned routes, auth and access control on every surface, and one error…
git:20260930.dc5adef · audit A · 4 stars
api-endpoint SKILL.md skill
univers42/claude-deal-with-the-devil · skills/api-endpoint/SKILL.md · Scaffold a new REST endpoint that mirrors the ones already there. Use when a route is missing, a handler needs wiring…
git:20260930.72181e1 · audit A · 4 stars
brainstorm SKILL.md skill
univers42/claude-deal-with-the-devil · skills/brainstorm/SKILL.md · Diverge wide on the options, then converge on evidence and cost, ending in one recommendation, a smallest experiment…
git:20261017.fcaf2cc · audit A · 4 stars
browser-testing SKILL.md skill
univers42/claude-deal-with-the-devil · skills/browser-testing/SKILL.md · Verifies a change in a real browser and returns the artifact: the steps, the viewport, the console. Use when a page is…
git:20260930.00e2d41 · audit A · 4 stars
caveat SKILL.md skill
univers42/claude-deal-with-the-devil · skills/caveat/SKILL.md · Give every heuristic, sample, regex parser, cache, timeout and derived number the one line saying what it gets wrong…
git:20260930.06ed519 · audit A · 4 stars
commit-craft SKILL.md skill
univers42/claude-deal-with-the-devil · skills/commit-craft/SKILL.md · Turn a working tree into a history someone can read, revert and bisect. Use when changes are uncommitted, one commit…
git:20260930.5b26a1e · audit B · 4 stars
context-budget SKILL.md skill
univers42/claude-deal-with-the-devil · skills/context-budget/SKILL.md · Measure and cut what a config costs in context every session: always-on rules, invocable descriptions, skills that…
git:20261017.fcaf2cc · audit A · 4 stars
debug SKILL.md skill
univers42/claude-deal-with-the-devil · skills/debug/SKILL.md · Find the actual cause of a failure instead of guessing at fixes. Use when a test fails, a build breaks, a crash has no…
git:20260930.5b26a1e · audit A · 4 stars
design-review SKILL.md skill
univers42/claude-deal-with-the-devil · skills/design-review/SKILL.md · Judges an interface by hierarchy, rhythm, type, consistency and the states nobody built, then names the smallest fix…
git:20261017.fcaf2cc · audit A · 4 stars
frontend SKILL.md skill
univers42/claude-deal-with-the-devil · skills/frontend/SKILL.md · Builds UI that holds up at every width, in both themes, with real data, and for someone on a keyboard. Use when a page…
git:20260930.00e2d41 · audit A · 4 stars
grill SKILL.md skill
univers42/claude-deal-with-the-devil · skills/grill/SKILL.md · Close the frontier between what is decided and what is still open: the facts are gathered from the repo, the decisions…
git:20260930.4cc15b2 · audit A · 4 stars

Every file in univers42/claude-deal-with-the-devil

Other files named doc-sync

doc-sync SKILL.md skill
jmagly/aiwg · agentic/code/addons/aiwg-utils/skills/doc-sync/SKILL.md · Synchronize documentation and code with bounded, scope-first drift checks
git:20260815.80ec389 · audit A · 225 stars
doc-sync SKILL.md skill
tykisgod/quick-question · skills/doc-sync/SKILL.md · Local on-demand doc-sync: detect doc↔code drift, draft the reconciling updates (anchors + prose), present them as a…
git:20261006.f0a700f · audit B · 12 stars

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