agentsclimarketplace

Revision escalation

Skill yha9806/academic-writing-toolkit/plugins/academic-writing-toolkit/skills/revision-escalation

Local-first, evidence-controlled academic writing workflows for AI agents, with bounded revision, clean-room review, and release governance.

Install
npx -y skills add yha9806/academic-writing-toolkit --skill revision-escalation

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

3.9 KB, as published. Nobody here has run it

/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.

Revision Escalation Check

Before editing again, classify the problem:

CategoryMeaningNext action
Underspecified requestTarget, constraint, audience, venue, or expected output is missing.Ask for a concrete target before editing.
Ambiguous feedbackFeedback is evaluative but not operational: "weird", "weak", "unclear", "not good enough".Ask what should change.
Local execution problemThe goal is clear, but the previous patch implemented it incorrectly.Make one small targeted patch.
Structural mismatchThe issue affects the research question, gap, contribution, evidence chain, section structure, module boundary, or venue framing.Propose a restructure plan before editing.
Evidence gapThe desired claim is unsupported by available data, experiments, citations, or files.Downgrade the claim or request evidence.
Version contaminationRepeated patches have mixed old assumptions with new requirements, causing inconsistency, duplication, or bloat.Recommend a new version, branch, or consolidated brief.

Required Response

When triggered, respond in this structure before any patch:

I should pause before making another patch.

This issue has already gone through several revision rounds and may not be a local wording or implementation problem anymore.

Current diagnosis:

* Category:
* Why:
* What is missing or conflicting:
* Recommended next action:

Options:
A. Clarify the concrete target and continue a local patch.
B. Consolidate all current requirements into a single brief, then retry.
C. Create a new version or branch and restructure the section/module.
D. Reframe the paper/project from the research question, gap, and evidence chain.

Academic Writing Rule

Classify manuscript work before editing:

  • Local patch: wording, grammar, citation format, figure caption, table formatting, or one paragraph.
  • Section-level restructure: one section changes, but the research question, contribution, and evidence chain stay stable.
  • Full reframing: title, abstract, introduction, research question, gap, contribution, methods-results alignment, discussion, or venue framing changes.

For full reframing, do not directly rewrite the manuscript. First produce a reframing brief with target venue, research question, gap, core claim, available evidence, claims that must not be made, and proposed new structure.

Red Flags

Stop and diagnose when thinking:

  • "One more patch should fix it."
  • "The user is still dissatisfied, but I can just rewrite harder."
  • "The wording is awkward" while the evidence chain or contribution boundary is unstable.
  • "The current version is messy, but I can keep accumulating edits."

Never continue accumulating edits on a structurally inconsistent manuscript, rebuttal, or code path.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.