revision-escalation SKILL.md skillA

revision-escalation from yha9806/academic-writing-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yha9806/academic-writing-toolkit/revision-escalation@git:20260905.68bae2c

Pins git:20260905.68bae2c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yha9806/academic-writing-toolkit
Path
archive/skills/revision-escalation/SKILL.md
Versions recorded
2
Latest version
git:20260905.68bae2c, committed Sep 5, 2026
First version recorded
Aug 16, 2026
Size
4,677 bytes
Repository stars
54
License
MIT

Stop repeated failed writing, coding, manuscript, rebuttal, or restructuring revisions when the same issue has gone through 3+ unsatisfactory edits, vague feedback such as still wrong/weird/unclear/weak/越改越乱, version contamination, or possible gap/claim/evidence/venue-fit drift.

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

# /revision-escalation - 3-Strike Revision Control

## Purpose

Prevent repeated local patches from making a draft or code path more inconsistent. Use this when the issue may no longer be wording or implementation detail, but specification, structure, evidence, or version-control drift.

## Trigger Words

This skill activates on: `revision escalation`, `3-strike`, `three strikes`, `stop and diagnose`, `still wrong`, `still weird`, `unclear`, `weak`, `越改越乱`, `还是不对`, `还是怪`, `不够清楚`, `逻辑还是混乱`, `/revision-escalation`.

## Core Rule

If the same issue remains unresolved after 3 revision attempts, treat it as a specification or structure problem before treating it as another local editing task.

Do not make a fourth patch immediately.

Repeated feedback that the manuscript is becoming more abstract, no longer
states who it helps, or contains individually correct sentences without a
recognisable paper spine is a structural signal even when fewer than three
formal edit contracts have failed. Pause and compare the current draft with
the author-intent and argument baselines.

## Revision Escalation Check

Before editing again, classify the problem:

| Category | Meaning | Next action |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yha9806/academic-writing-toolkit/revision-escalation@sha256:1921bc954700e0f3

The line at the top of this page pins the label git:20260905.68bae2c, 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_6qtz6bicm6nvyzbg.svg)](https://markdownregistry.com/a/art_6qtz6bicm6nvyzbg)

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

Versions

The registry has recorded 2 versions of this file, between Aug 16, 2026 and Sep 5, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260905.68bae2c latest2026-09-05 68bae2c 4,677 BA view · diff
git:20260816.d9582322026-08-16 d958232 4,007 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 (4677 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

yha9806/academic-writing-toolkit · 54 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6qtz6bicm6nvyzbg
GET https://markdownregistry.com/api/v1/resolve?ref=yha9806/academic-writing-toolkit/revision-escalation
GET https://markdownregistry.com/api/v1/blob/1921bc954700e0f31854ebdd0df4d07cefbbb62ad7ce41371873f79f72fc2e6f

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 yha9806/academic-writing-toolkit

audit SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/audit/SKILL.md · Check thesis chapters for consistency before submission — contradictory numbers, terminology drift, and broken…
git:20261009.ad89acd · audit A · 54 stars
export SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/export/SKILL.md · Convert thesis chapters and reading notes from Markdown to Word (.docx) and package for submission. Use when preparing…
git:20260907.589edde · audit A · 54 stars
integrate SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/integrate/SKILL.md · Map reading notes to thesis chapters and integrate key arguments into the manuscript. Use after completing a reading…
git:20260920.f7e7cc9 · audit A · 54 stars
map SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/map/SKILL.md · Show literature-to-chapter coverage and the writing progress dashboard — which sources support which chapters, and word…
git:20260920.f7e7cc9 · audit A · 54 stars
note SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/note/SKILL.md · Record reading notes to a structured notes file. Use when the user says "take notes" or "record this" during reading…
git:20260920.f7e7cc9 · audit A · 54 stars
read SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/read/SKILL.md · Read PDF page by page with structured output — key arguments, terms glossary, thesis connections. Use when reading…
git:20260920.f7e7cc9 · audit A · 54 stars
readers SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/readers/SKILL.md · Open a reader panel. Instruction-bound amnesiac sub-agents read the abstract or introduction and report what they…
git:20261008.1ec6549 · audit A · 54 stars
review SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/review/SKILL.md · Review a manuscript or chapter as an external reviewer, or run an own-work self-review in a fresh-context clean room…
git:20260920.ce7b9ba · audit A · 54 stars
verify-refs SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/verify-refs/SKILL.md · Use when checking BibTeX reference records for missing fields, malformed identifiers, duplicate keys, or metadata…
git:20261007.26f80db · audit A · 54 stars
academic-writing Cursor rule
yha9806/academic-writing-toolkit · .cursor/rules/academic-writing.mdc · Academic writing conventions — reading notes format, chapter structure, consistency rules
git:20260427.1b9c69b · audit A · 54 stars
AGENTS.md AGENTS.md file
yha9806/academic-writing-toolkit · AGENTS.md
git:20260907.589edde · audit A · 54 stars
CLAUDE.md CLAUDE.md file
yha9806/academic-writing-toolkit · CLAUDE.md
git:20260427.bf32c54 · audit A · 54 stars

Every file in yha9806/academic-writing-toolkit

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