Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
AI & knowledge

prose-lint

use before circulating any scientific text, human- or LLM-drafted — a clarity and integrity linter: hype vocabulary, empty sentence structures, agentless prose, number discipline, and honesty failures; one pass is never enough.

BootLoops-ai · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add BootLoops-ai/skills --skill prose-lint

About this skill


name: prose-lint description: use before circulating any scientific text, human- or LLM-drafted — a clarity and integrity linter: hype vocabulary, empty sentence structures, agentless prose, number discipline, and honesty failures; one pass is never enough.

prose-lint

THE MASTER TEST, before and above every class below: read each sentence and ask — would a specific human scientist say this, out loud, across a table to a colleague? Not "is it grammatical," not "does it match a banned pattern" — would a person SAY it. If you cannot hear a human saying the sentence, it fails, whether or not any catalogued class matches. The catalogue below exists to help you find such sentences and to name the cure; it is never the boundary of the offense. A pass that runs every grep and skips this question is not a lint.

This skill improves clarity and honesty. It is not a tool for concealing AI involvement: disclose AI assistance as your venue requires; Section E applies to authorship statements too.

Quickly produced drafts, by people or by language models, share habits that careful readers distrust. A reader who has seen a lot of it flinches at the patterns below even when each sentence is individually fine. Run this as a dedicated pass — never assume a draft is clean because it "reads okay." Read every paragraph as if aloud; anything that sounds like a press release, a chatbot, or a social-media post gets rewritten in plain, concrete language.

Two hard truths:

  1. One pass is never enough. These tells regenerate every time the text is rewritten. Scrub, then scrub again with fresh eyes, paying special attention to the opening sentence, every subheading, and every closing sentence — that is where they hide.
  2. The honesty tells (Section E) matter most. A clunky sentence is cosmetic. A fabricated number, an inflated claim, or a mislabeled source is a lie. Hunt those first.

A. Banned / suspect vocabulary

If one of these appears, it is almost always wrong. Delete or replace with a plain, specific word.

Hype nouns/verbs: delve, tapestry, realm, testament, underscore, leverage, unlock, unleash, navigate (figuratively), foster, embark, journey, showcase (as verb), spearhead, harness the power of, supercharge. Marketing adjectives: seamless, robust, cutting-edge, game-changing, revolutionary, transformative, groundbreaking, multifaceted, intricate, vibrant, profound, rich (figuratively), powerful (as filler), unprecedented. Set phrases: "harness the power of", "the world of", "dive into" / "deep dive", "at the forefront", "pushing the boundaries", "a paradigm shift", "the beauty of", "stands as", "serves as a testament", "a beacon of", "plays a vital/crucial/pivotal role", "boasts", "a treasure trove", "in today's world", "ever-evolving", "rapidly evolving", "needless to say", "at the end of the day", "simply put", "it goes without saying". Weasel openers: "It's worth noting that", "It's important to note", "It is worth mentioning", "Notably,", "Importantly," (when it adds nothing), "Make no mistake". Summary throat-clearing: "In conclusion", "In summary", "Ultimately,", "All in all", "To sum up".

Allowed-in-context exceptions: a word used literally (a software harness, a physical journey) or as a genuine technical term. The ban is on the cliché use, not the real one. The defined-in-document exception: a suspect token the document itself formally defines ("we call a value certified when …") is earned vocabulary from the definition onward — demote the hit to a note and check that the definition really exists and precedes the uses.

A2. Metaphor and register classes (each with its cure)

Commerce metaphors for information/evidence: "the constants price the question", "a menu of methods", "what this buys", "cost" for anything other than literal compute time or literal sample size. Cure: state the actual quantity — "takes about 3 million samples" is fine; "the constants price the question" is not.

Vague elevation metaphors: "one floor up", "one level up", "one rung above", "the mathematical ladder", and kin. Cure: name the concrete thing — the class, or the actual dimension/order count ("the genus-two case, one step above genus one"). A named, literal ladder with real rungs stays allowed.

Vague locative abstractions: "the places where that stops are known precisely", "the point at which X breaks down", "on both sides of that boundary", "where the field currently stands" — geography metaphors standing in for specific objects. The tell: a WHERE-word (places, point, boundary, side, landscape, territory) carrying a claim about specific objects. Cure: name the objects — "exactly two cases are known to require more". A literal boundary (a physical region, an integration domain) is fine.

"The field says" over-attribution: "when the field says", "the field declared it impossible", "the field stopped trying" — generalizing one paper's or one group's statement to an entire discipline. Both a tone tell (gotcha framing toward likely referees) and an honesty tell (an attribution a source check refutes). Cure: attribute to the actual source, quoted or named ("Smith et al. call it 'impossible to evaluate directly'"), or scope to the actual subcommunity. If you cannot name who says it, the sentence is not ready.

Capability-fanfare openers: "the two theories can finally be compared", "X makes it possible to Y", "this opens the door to" — announcing that an act has become possible instead of performing it. Cure: do the thing — "We compare the prediction with the archival data." If the document doesn't do it, it's future work, stated as an open item, not fanfare.

Paragraph-opening anaphora: a new paragraph must not open on an unanchored pronoun or deictic — "We now cross it", "This changes the picture", "That is the subject of...", "It follows that..." as paragraph OPENERS force the reader back across the break to find t

Read the complete source ↗