AGENT SKILL

unslop-academic-writing

Remove AI slop from research writing so papers, theses, grant proposals, reviews and rebuttals read as written by a careful human expert. Covers stock vocabulary (delve, tapestry, pivotal, underscores), empty emphasis, hedge stacks, formulaic signposting, "not only X but also Y" constructions, em-dash pileups, monotone rhythm, and claims vaguer than the data. Use when drafting or revising academic text with an AI assistant, when a draft "sounds like ChatGPT", before submission, or to match an author's own voice. Includes a zero-dependency slop linter for Markdown, LaTeX, text and Word files.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
unslop-academic-writing
license
MIT
metadata
{ "tags": "AI slop, academic writing, tone, voice, humanize, clarity, editing, scientific writing", "author": "Kalaris Labs (Sayan Chowdhury)", "version": "1.0", "category": "research-writing", "maintainer": "Kalaris Labs" }
description
Remove AI slop from research writing so papers, theses, grant proposals, reviews and rebuttals read as written by a careful human expert. Covers stock vocabulary (delve, tapestry, pivotal, underscores), empty emphasis, hedge stacks, formulaic signposting, "not only X but also Y" constructions, em-dash pileups, monotone rhythm, and claims vaguer than the data. Use when drafting or revising academic text with an AI assistant, when a draft "sounds like ChatGPT", before submission, or to match an author's own voice. Includes a zero-dependency slop linter for Markdown, LaTeX, text and Word files.
compatibility
Python 3.9+ standard library for scripts/slop_check.py.

02 资源文件 3

03 SKILL.md 正文

Unslop Academic Writing

Slop is prose that is fluent but says less than it seems to. Readers, reviewers and editors now recognize it on sight, and it costs credibility even when the science is sound. The fix is specificity: every sentence should carry information a generic paper on the topic would not.

This skill is about clarity and authorship, not about disguising AI use. Follow the venue's policy on AI assistance (most require disclosure, see reproducibility-statement). The author remains responsible for every claim.

Workflow

  1. Measure. Run the linter on the draft (or a section):

    python scripts/slop_check.py manuscript.tex
    python scripts/slop_check.py intro.md --json > slop.json
    

    It ignores math, citations, code and markup. Index bands: < 5 clean, 5-15 some slop, 15-30 heavy, > 30 severe. Each finding has a line number and a rewrite hint.

  2. Fix content first, words last. Work top-down. Polishing vocabulary in a paragraph that should not exist is wasted effort.

    Level Question Typical fix
    Claim Does each paragraph make one claim a specialist would find non-obvious? Cut paragraphs that restate the field; merge duplicates
    Evidence Is every claim tied to a number, citation, figure or method? Replace "significantly improves" with the effect size, interval and test
    Structure Does the logic carry the connection, or do signposts ("Moreover") fake it? Reorder sentences so each follows from the last; delete connective filler
    Rhythm Do sentence lengths vary with content? Short sentence for the key finding; longer ones for mechanism and caveats
    Words Stock vocabulary, hype, stacked hedges? Use the hints and references/patterns.md
  3. Preserve what matters. Never change numbers, units, citations, technical terms, defined abbreviations or the strength of a claim while "unslopping". Hedges that reflect genuine uncertainty stay. Remove only the second hedge in a stack.

  4. Match the author's voice. Ask for 1-3 pages the author wrote before using AI (a previous paper or thesis chapter). Note their sentence length, use of "we"/"I", preferred transitions and terminology, then keep the revision within that range. Follow the discipline norms in references/discipline-voice.md.

  5. Re-measure and read aloud. Target an index under 5 for abstracts and introductions, under 10 for methods-heavy sections. The linter is a floor, not a judge: finish by reading the text as a skeptical reviewer.

Rewrite rules (apply in order)

  1. Delete the frame, keep the point. "It is important to note that X" → "X".
  2. Replace abstraction with the specific thing. "a wide range of tasks" → "12 of the 14 benchmark tasks".
  3. Replace evaluation with evidence. "a remarkable improvement" → "a 9.4-point improvement (95% CI 7.1-11.7)".
  4. Name the mechanism, not the role. "plays a pivotal role in" → "is required for", "accounts for 40% of".
  5. One hedge, sized to the evidence. "may potentially suggest" → "suggests" (strong data) or "is consistent with" (weak data).
  6. State the contrast directly. "not only X, but also Y" → "X and Y", or keep only the stronger point.
  7. Use the verb. "perform an analysis of" → "analyse"; "provide a description" → "describe".
  8. Let structure replace signposts. Delete "Moreover/Furthermore/Additionally" where the logical relation is clear.
  9. Punctuate normally. Most em dashes become commas, colons, parentheses or full stops.
  10. Vary rhythm deliberately. After two long sentences, write a short one that states the takeaway.

Before and after

Before: In today's rapidly evolving landscape, single-cell technologies play a pivotal role in unraveling the intricate tapestry of cellular heterogeneity. It is important to note that our novel framework significantly outperforms existing methods, paving the way for groundbreaking discoveries.

After: Single-cell RNA-seq atlases now exceed 10 million cells, but cluster labels still disagree between annotation tools on about 20% of cells. Our method reduced this disagreement to 7% on three held-out atlases (paired t-test, p < 0.01), mainly by resolving T-cell subtypes that marker-based tools merge.

Integrity rules

  • Never fabricate specifics to replace vague text. If the draft lacks the number or citation, ask the author or mark a placeholder such as [N = ?].
  • Verify that each rewritten sentence says the same thing as the original, at the same strength.

What the linter cannot judge

Accuracy, novelty, whether a citation supports the sentence, or whether the argument is right. Pair this skill with citation-verification, scientific-critical-thinking and a human co-author's read.

Related skills

scientific-writing, ml-paper-writing, abstract-and-title, rebuttal-and-response-to-reviewers, cover-letter-to-editor, peer-review, reproducibility-statement.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k