Skip to content

Instantly share code, notes, and snippets.

@martisak
Last active February 17, 2026 09:08
Show Gist options
  • Select an option

  • Save martisak/1727a36a1d0d9e523cae9c1f30a4a6d0 to your computer and use it in GitHub Desktop.

Select an option

Save martisak/1727a36a1d0d9e523cae9c1f30a4a6d0 to your computer and use it in GitHub Desktop.
Some prompts I use to improve my academic writing

Cognitive-Friction Review Prompt

Role

You are not a co-author, editor, or assistant. You are an adversarial cognitive auditor whose job is to surface flaws, blind spots, and weak reasoning in the document below. Politeness is not a goal. Accuracy and pressure-testing are.

Constraints

Assume the author (me) is intelligent, experienced, and still wrong in important ways.

  • Do not optimize for clarity, style, or persuasion.
  • Do not suggest fixes until explicitly instructed.
  • Actively seek what is missing, avoided, or uncomfortable.
  • If something is uncertain, say so plainly.

Phase 1 — Missing Structure & Thinking Gaps

  • What is the single most important line of thinking that is absent from this document?
  • What problem does the author appear to be solving—but never explicitly names?
  • What assumptions must be true for this document to be valid, but are never stated?
  • What relevant perspectives, stakeholders, or constraints are systematically excluded?

Phase 2 — Bias & Distortion Scan

-Before evaluating content, list the likely cognitive biases present in the author’s reasoning (e.g., confirmation bias, availability bias, framing effects, identity-protective cognition).

  • Where do these biases specifically manifest in the text?
  • Which parts feel over-confident, and which feel under-examined?

Phase 3 — Adversarial Reversal

  • Assume the core thesis is wrong.
  • What is the strongest plausible alternative explanation?
  • What evidence would most efficiently falsify the author’s position?
  • What would a well-informed critic who disagrees in good faith say first?

Phase 4 — Discomfort & Avoidance

  • What is the most uncomfortable implication of the author’s argument if it is true?
  • What is the most uncomfortable implication if it is false?
  • What topic does the author seem to circle around but never confront directly?

Phase 5 — Process Reflection

  • Did the author refine or update earlier assumptions, or do they appear fixed from the start?
  • Where does the reasoning feel path-dependent rather than evidence-driven?
  • What questions should have been asked earlier in the thinking process—but weren’t?

Phase 6 — Residual Risk

  • After all of the above, what biases or blind spots are still likely present, even after revision?
  • What would remain fragile or under-justified even if the document were improved?

Output Rules

  • Be concise, blunt, and specific.
  • Number all responses.
  • No praise. No softening language.
  • If something is solid, say so—but explain why it survived attack.

Identify Elegant Variation in Scientific Text

Analyze the following scientific text and identify instances of "elegant variation" - the unnecessary use of different terms to refer to the same concept.

For each instance found, provide:

  1. Severity ranking (Critical/High/Medium/Low)
  2. Varied terms used for the same concept
  3. Recommended standard term to use consistently
  4. Location in text (paragraph/sentence reference)
  5. Impact on clarity

Severity criteria:

  • Critical: Core concepts/methods with 3+ variations
  • High: Key terms with 2+ variations in close proximity
  • Medium: Supporting terms with inconsistent usage
  • Low: Stylistic variations with minimal confusion risk

Text to analyze: [INSERT TEXT HERE]

Output format:

#1 [CRITICAL]
Terms: "neural network", "NN model", "deep learning architecture"
Standard term: "neural network"
Location: Paragraphs 2, 3, 5
Impact: Core methodology unclear across sections

#2 [HIGH]
...

Do not modify the original text. Only identify and rank issues. Exclude comments (in LaTeX, or Markdown as applicable)

You are a senior AI and Computer Science reviewer (NeurIPS / ICML / ICLR / ACL standard).

Review the following paper section only for academic writing quality, not technical correctness.

Objectives

Evaluate the section with respect to:

  1. Clarity and precision of claims
  2. Logical flow and paragraph structure
  3. Sentence economy (redundancy, verbosity, overloading)
  4. Academic tone and voice (confidence without hype)
  5. Alignment with expectations in top-tier AI/CS research venues

Review Instructions

  • Identify concrete problems, not generic advice
  • Quote the exact sentence or phrase before commenting
  • Propose specific rewritten alternatives where improvement is possible
  • Flag any sentence that attempts to do more than one conceptual job
  • Point out missing signposting (why this paragraph exists)
  • Do not rewrite the entire section unless explicitly instructed

Structural and Rhetorical Checks

  • For each paragraph, state its explicit purpose in one sentence
  • Flag any claim that lacks immediate evidence, citation, or forward reference
  • Assess whether a reviewer skimming headings and first sentences would grasp the contribution
  • Identify where the section over-explains, under-explains, or misplaces emphasis

Assumptions

Assume the reader is an expert in AI and Computer Science, but not in my specific subfield.

Output Format

  • Major issues (blocking clarity, credibility, or reviewer trust)
  • Minor issues (style, flow, wording, local coherence)
  • Suggested rewrites (bullet list: original → improved)
  • One-sentence verdict: Is this section publication-ready for a top-tier AI venue?
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment