Jak używać
- Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
- W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
- Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/kalarislabs/research-agent-skills --skill unslop-academic-writingPrzed rozpoczęciem
- Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
- Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.
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
- 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.jsonIt 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.
- 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 |
- 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.
- 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.
- 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)
- Delete the frame, keep the point. "It is important to note that X" → "X".
- Replace abstraction with the specific thing. "a wide range of tasks" → "12 of the 14 benchmark tasks".
- Replace evaluation with evidence. "a remarkable improvement" → "a 9.4-point improvement (95% CI 7.1-11.7)".
- Name the mechanism, not the role. "plays a pivotal role in" → "is required for", "accounts for 40% of".
- One hedge, sized to the evidence. "may potentially suggest" → "suggests" (strong data) or "is consistent with" (weak data).
- State the contrast directly. "not only X, but also Y" → "X and Y", or keep only the stronger point.
- Use the verb. "perform an analysis of" → "analyse"; "provide a description" → "describe".
- Let structure replace signposts. Delete "Moreover/Furthermore/Additionally" where the logical relation is clear.
- Punctuate normally. Most em dashes become commas, colons, parentheses or full stops.
- 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.
