Skip to content

Poisoneddiety/claude-skills-for-humanities / skills/academic-prose-audit

academic-prose-audit

Verified

Audit and revise drafted academic legal prose for propositional compression, mechanical sentence rhythm, and AI register, while preserving formal academic voice and OSCOLA conventions. Fixes the defect where too much meaning is left for the reader to reconstruct. Use this on any draft paper, response paper, seminar piece, or long note before submission, and whenever the user says a draft reads mechanically, sounds like AI, or needs humanising. Do NOT use for first drafts, exam answers, or casual chat.

FileKindSize
SKILL.mdskill md7.3 KB
references/patterns.mdmarkdown8.9 KB
scripts/audit.pyscript14.0 KB

references/patterns.md

View on GitHub
# Compression Patterns — Worked Examples

Read this during the judgement pass. Each pattern is given with a defective example drawn from
the kind of prose this skill exists to fix, the diagnosis, and a repair.

## Contents

1. Buried actor
2. Elided middle term
3. Stacked proposition
4. Undefined term of art
5. Citation doing an argument's work
6. Conclusion smuggled into a premise
7. Floating demonstrative
8. False precision and decorative hedging
9. Register: what to cut and what to keep

---

## 1. Buried actor

**Defective.** "The determination of whether an agency relationship exists is dependent upon an
assessment of the totality of the circumstances."

**Diagnosis.** Two nominalisations, `determination` and `assessment`, each concealing a verb and
an actor. Nobody determines anything and nobody assesses anything; the processes float free. The
reader has to reconstruct that a court is doing both.

**Repaired.** "A court decides whether an agency relationship exists by weighing all the
circumstances together rather than any single factor."

**Note.** The repair is not merely shorter. It supplies information the original omitted: that
the actor is a court, and that "totality" means no single factor is decisive. Nominalisation
does not just obscure, it discards.

---

## 2. Elided middle term

**Defective.** "The company was incorporated to hold the disputed land. The veil may therefore
be pierced."

**Diagnosis.** A therefore C. The unstated premise is that incorporation for the purpose of
holding property, without more, amounts to a device to evade an existing obligation — which is
precisely the contested proposition. Leaving it out makes the inference look automatic when it
is the whole question.

**Repaired.** "The company was incorporated to hold the disputed land. If a company is formed
for the specific purpose of defeating an obligation that already binds its promoters, courts
have treated the corporate form as a device rather than a genuine separation of interests. The
veil may therefore be pierced, provided the pre-existing obligation is established."

**Test.** Write the argument as a syllogism. If the minor premise cannot be quoted from the
draft, it is missing.

---

## 3. Stacked proposition

**Defective.** "The judgment, which departs from the settled position without acknowledging it,
introduces a public interest ground that lacks any statutory anchor and would, if followed,
displace the agency test that has governed this area since the leading authority."

**Diagnosis.** Three independently arguable claims in one sentence: that it departs without
acknowledgement, that the ground lacks statutory anchor, and that it would displace the existing
test. Each requires separate support. Fused, none is properly defended and the reader cannot
tell which the author regards as load-bearing.

**Repaired.** "The judgment departs from the settled position without acknowledging that it does
so. The public interest ground it introduces has no statutory anchor. If followed, it would
displace the agency test that has governed this area since the leading authority — and it is
this third consequence, rather than the departure itself, that makes the decision difficult to
accommodate."

**Note.** Splitting also let the author signal priority, which the fused version could not.

---

## 4. Undefined term of art

**Defective.** "The Court applied the alter ego doctrine, notwithstanding the absence of a
finding on beneficial ownership."

**Diagnosis.** Two terms of art, neither defined, in a sentence whose meaning turns on both. A
reader who does not already know the answer cannot follow.

**Repaired.** "The Court applied the alter ego doctrine — the principle that a company may be
treated as identical with its controller where the company has no independent decision-making
existence — even though it made no finding on beneficial ownership, that is, on who ultimately
enjoyed the economic benefit of the shareholding."

**Rule.** Define on first use, including terms that feel elementary. If the definition itself
contains a term of art, define that too.

---

## 5. Citation doing an argument's work

**Defective.** "Piercing on public interest grounds cannot survive scrutiny (see *Balwant Rai
Saluja*)."

**Diagnosis.** The citation is standing where reasoning should be. The reader is told a case
exists and left to infer what it held, why it applies, and what work it does in the argument.
This is the most common form of compression in student writing and the easiest for an examiner
to penalise, because it looks like support while supplying none.

**Repaired.** "In *Balwant Rai Saluja*, the Court held that the veil may be lifted only on
proof of a specific, identifiable ground, and expressly declined to treat generalised
considerations of fairness as sufficient. A freestanding public interest ground would collapse
precisely the limit that reasoning imposes, and therefore cannot stand alongside it."

**Rule.** State what the case held, then state why it bears. Keep the citation.

---

## 6. Conclusion smuggled into a premise

**Defective.** "The doctrinally unsustainable public interest ground was applied by the Court to
reach a result that…"

**Diagnosis.** If the paper's thesis is that the ground is doctrinally unsustainable, that
cannot appear as an adjective in the description of what the Court did. The conclusion is being
asserted at the point where the facts are being set out, which begs the question and makes the
argument circular.

**Repaired.** "The Court applied a public interest ground to reach a result that… Whether that
ground can be sustained doctrinally is the question this paper addresses."

**Rule.** Descriptive sections describe. Evaluative modifiers are earned in the analysis and
appear there.

---

## 7. Floating demonstrative

**Defective.** "This suggests that the bench-strength constraint is decisive."

**Diagnosis.** `This` refers to some portion of the preceding two paragraphs, but which portion
is left to the reader. Where the preceding material contains several distinct points, the
reference is genuinely ambiguous, and the reader must guess which one the author thinks is
doing the work.

**Repaired.** "The Court's silence on the earlier three-judge holding suggests that the
bench-strength constraint is decisive."

**Rule.** Every demonstrative pronoun opening a sentence should be followed by a noun naming its
referent, or replaced by that noun.

---

## 8. False precision and decorative hedging

Two opposite errors, both worth catching.

**Decorative hedging.** "It may arguably be possible to suggest that the doctrine could
potentially apply." Four hedges cancelling each other. The author either thinks it applies or
does not. Repair: "The doctrine arguably applies, though no decision has yet said so." One
hedge, and the reason for it is given.

**Genuine hedging — keep.** "Whether the ground survives after the 2014 decision is unsettled;
the High Courts have divided and the Supreme Court has not returned to the point." This is not
weak writing. It is accurate, and removing the hedge would make the sentence false.

**The distinguishing test.** Can you state *why* the qualification is there? If yes, keep it and
state the reason. If no, cut it.

**False precision** is the mirror image: "The doctrine has been applied in seventeen reported
decisions since 2014." Unless that count was actually performed, it is fabrication dressed as
rigour. Prefer "in a number of decisions since 2014, including X and Y" over an invented
figure.

---

## 9. Register: what to cut and what to keep

**Cut.** `delve`, `landscape` used metaphorically, `robust`, `seamless`, `underscores`,
`pivotal`, `crucial` as filler, `navigate` used metaphorically, `leverage` as a verb, `myriad`,
`tapestry`, `realm`, `paradigm`, `holistic`, `multifaceted`, `intricate`, `compelling`,
`testament`.

**Cut.** `it is worth noting` and `it is important to note` where no reason follows,
`plays a crucial role`, `highlights the importance of`, `sheds light on`, `in today's`,
`at its core`, `cannot be overstated`, `a delicate balance`, `a double-edged sword`.

**Cut.** Sentence-opening `Moreover`, `Furthermore`, `Additionally`, `Notably`, `Importantly`
used as connective filler. If the sentences are genuinely connected, name the connection —
`because`, `although`, `which means that`. If they are not, the paragraph has a structural
problem that a transition word is concealing.

**Cut.** The `not merely X, but Y` construction and its variants. It manufactures significance
by contrast rather than stating the claim.

**Cut.** Tricolon by default. Three-item lists appear because three sounds complete, not because
there are three things. Where there are two, give two.

**Keep.** Latin terms of art. Formal connectives that do logical work — `it follows that`,
`on that reasoning`, `conversely`, `by contrast`. Signposting in a long paper. Qualifications
that track genuine doctrinal uncertainty. Passive voice where the actor is irrelevant. Long
sentences that carry qualified propositions accurately.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall