Skip to content
Content
Skill

/amann-revision

Use when responding to an Academy of Management Annals (Annals) proposal decision or full-review referee letter — framework/attitude asks, coverage gaps, balance complaints, and accessibility. Drafts the response letter and revision plan; it does not run the portal preflight

From plugin
awesome-journal-skills
965200 skills
Install
$ npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill amann-revision --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/amann-revision

Context preview

The summary Claude sees to decide when to auto-load this skill.

Use when responding to an Academy of Management Annals (Annals) proposal decision or full-review referee letter — framework/attitude asks, coverage gaps, balance complaints, and accessibility. Drafts the response letter and revision plan; it does not run the portal preflight

SKILL.md

amann-revision.SKILL.md
name: amann-revision
description: Use when responding to an Academy of Management Annals (Annals) proposal decision or full-review referee letter — framework/attitude asks, coverage gaps, balance complaints, and accessibility. Drafts the response letter and revision plan; it does not run the portal preflight (amann-submission) or redesign the framework from scratch (amann-organizing-framework).

Revision & Response for a Review (amann-revision)

When to trigger

  • A proposal decision letter arrived (invited / revise-and-resubmit / declined)
  • A full-review referee letter arrived (major revision is the norm for a long review)
  • Referees flagged "no real framework," missing streams, imbalance, or "reads like a list"
  • You need a point-by-point response letter for a review article, not a primary paper

First: which letter is this?

Annals' two-step process produces two kinds of feedback, and they call for different moves:

  • **Proposal-stage feedback** (double-blind, from the Associate Editors). The decision is mainly about *fit and promise*: is the literature Annals-scale, and is there a genuinely new framework under "New insights"? A revise-and-resubmit here usually means sharpen the contribution before the full review is invited — route back through `amann-topic-selection` / `amann-organizing-framework` / `amann-proposal-framing`.
  • **Full-review feedback** (editor-only: Associate Editor and Editor). The review is being developed; feedback is about *execution* — framework strength, coverage, balance, attitude, accessibility. This is the classic point-by-point revision below.

Categories of full-review feedback (and how to answer each)

Triage every point into one bucket:

| Feedback type | Typical phrasing | Response move | |---------------|------------------|---------------| | **Framework / contribution** | "this is an annotated bibliography" / "where is the integration?" | strengthen or make explicit the spine (`amann-organizing-framework`); do not just reorder — this is the acceptance bar | | **Attitude / agenda** | "this is descriptive; take a position" / "the agenda is generic" | add the critical position and a framework-tied agenda (`amann-writing-style`) | | **Coverage gap** | "you omit the X stream / author Y" | almost always *concede and integrate*; place the work in the right cell; re-run saturation (`amann-literature-synthesis`) | | **Balance / fairness** | "this slights school Z / over-cites the author" | steelman the slighted side; re-audit self-citation (`amann-evidence-standards`) | | **Appraisal accuracy** | "you mischaracterize study W" | correct it precisely — reviewed authors often referee | | **Scope** | "too broad / too narrow" | renegotiate with the editor (`amann-editor-strategy`); rescope deliberately, not by random cuts |

Writing the response letter

  • **Point-by-point, quote-then-respond.** Reproduce each comment, then state the change and where it lives (section/page/table/figure).
  • **Framework asks are existential — answer them first.** "No real framework" is a reject reason at Annals; a stronger or more explicit spine, not reordered paragraphs, is the required answer.
  • **Coverage asks: concede gracefully and integrate.** A missing stream is a real defect in a review-of-the-field; adding it strengthens the article. Resist defensiveness.
  • **Balance asks: show the steelman.** Demonstrate the revised text states the other side at its strongest.
  • **Disagree rarely and respectfully.** If an ask would break the framework or expand scope unfinishably, explain the trade-off and propose an alternative, ideally pre-cleared with the editor.
  • **Keep the editor central.** Because the full review is developed with the AE and Editor, route scope conflicts and incompatible asks to them rather than trying to satisfy everyone.
  • **Track every addition's ripple.** Adding a stream can shift the review's center of gravity; after each integration, re-check that the framework cells, the synthesis tables, and the balance audit still hold.

Checklist

  • [ ] Identified whether the letter is proposal-stage (fit/promise) or full-review (execution)
  • [ ] Every comment triaged (framework / attitude / coverage / balance / appraisal / scope)
  • [ ] "No framework" / "annotated bibliography" answered with a stronger explicit spine, not reordering
  • [ ] "Descriptive" answered by adding a critical position + framework-tied agenda
  • [ ] Coverage gaps conceded and integrated into the right cell; saturation re-run
  • [ ] Balance complaints answered by demonstrable steelmanning + self-citation re-audit
  • [ ] Mischaracterizations corrected precisely (reviewed authors may be the referees)
  • [ ] Scope conflicts routed to the editor for adjudication
  • [ ] Point-by-point letter: quote-then-respond, with section/page/table locations
  • [ ] Framework, coverage, and balance re-audited after all additions

Anti-patterns

  • "Fixing" a no-framework critique by shuffling paragraphs without strengthening the spine
  • Answering a "be more provocative" ask with the same neutral prose
  • Defending an omission rather than adding the missing stream (a review gap is a real defect)
  • Answering a balance complaint with assertions of fairness instead of revised, steelmanned text
  • Mischaracterizing or dismissing a reviewed author who is likely your referee
  • Bloating scope to satisfy every "also cover…" until the review no longer finishes

Output format

【Letter type】proposal-stage (fit/promise) / full-review (execution)
【Triage】each comment bucketed (framework/attitude/coverage/balance/appraisal/scope)? Y/N
【Framework asks】spine strengthened/made explicit (not reordered)? Y/N
【Attitude/agenda】critical position + framework-tied agenda added? Y/N
【Coverage gaps】conceded + integrated into cells; saturation re-run? Y/N
【Balance】steelman shown in revised text; self-citation re-audited? Y/N
【Scope conflicts】routed to editor? Y/N
【Letter】point-by-point, quote-then-respond, with locations
Read more
Ships withawesome-journal-skills

Stanford REAP × CoPaper.AI · 由斯坦福实证方法论团队精选与维护 访问 copaper.ai 微信:CoPaper.AI 按 11 个主流学科板块覆盖 经管与商科 社会科学 人文学科 数学与物理科学 生命科学 医学与健康 工程与技术 计算机科学与 AI 体育科学 点击任一学科名可跳转到对应说明;每类下的代表子领域在正文总览中完整列出。下方封面墙按 venue 导航,完整分类见覆盖一览。 🧭 布局指南 · 📚 Skill Pack 一览 · ⚡ 如何使用 · 🧪 自动实证

Get the whole plugin
Stats
965
Stars
121
Forks
Active
Maintenance
Stata
Language
MIT
License
13h ago
Last commit
2mo ago
Created

Repo: brycewang-stanford/Awesome-Journal-Skills

Other skills on awesome-journal-skills.