Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
Scans drafts for technical jargon, unexplained acronyms, and insider language, providing plain-language alternatives for each. Use when editing specialist content for a general audience.
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:jargon-flaggerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Scans a draft and flags every instance of technical jargon, unexplained acronyms, and insider language that a general-audience reader would not understand — with a plain-language alternative for each.
Reviews technical writing for clarity and accessibility by flagging unexplained jargon, hand-wavy process descriptions, and skipped steps. Useful when reviewing documentation, tutorials, or process-heavy content.
Translates scientific, legal, financial, and technical jargon into plain language for general audiences. Preserves accuracy while flagging precision trade-offs.
Reviews prose for communication issues that impede comprehension, applying minimal fixes and Microsoft Writing Style Guide principles. Useful for improving clarity in markdown, plain text, or text-heavy XML.
Share bugs, ideas, or general feedback.
Scans a draft and flags every instance of technical jargon, unexplained acronyms, and insider language that a general-audience reader would not understand — with a plain-language alternative for each.
Required: The draft text to be reviewed.
Optional: The target audience's assumed knowledge level (e.g., "general newspaper reader," "informed but non-specialist," "industry audience who knows the basics"); the subject domain (helps calibrate what counts as jargon vs. common knowledge in that field); any terms you have already decided to keep and do not want flagged.
Establishes the knowledge baseline. Determines what a reader of the stated audience would reasonably be expected to understand. For a general newspaper reader, terms like "GDP" or "DNA" are assumed known; "quantitative easing" or "epigenetics" are not. For an informed-but-non-specialist audience, the threshold is higher. If no audience is specified, defaults to a general magazine reader.
Scans for three categories. Flags items in three tiers:
Provides alternatives. For each flagged term, offers a plain-language replacement or a brief definition that could be inserted parenthetically. Does not rewrite the surrounding sentence — provides the replacement term only so the writer can integrate it in their own voice.
Assesses overall accessibility. After the item list, gives a brief verdict: how jargon-heavy the piece is relative to its intended audience, and whether the flagged items are concentrated in one section or distributed throughout.
A numbered list of flagged items, each formatted with the term, its category, its location in the text, and a plain-language alternative. Followed by a brief accessibility verdict. No rewriting of full passages — alternatives are targeted replacements or parenthetical definitions.
**Jargon Report**
*Audience baseline: [stated or assumed audience]*
1. **"[term]"** (Para [N]) — [Jargon / Acronym / Insider language]
→ Plain alternative: "[replacement or definition]"
2. **"[term]"** (Para [N]) — [Jargon / Acronym / Insider language]
→ Plain alternative: "[replacement or definition]"
---
**Accessibility Verdict:** [2-3 sentences on overall jargon density and distribution]
Audience: General newspaper reader Domain: Healthcare policy Draft (280 words):
The government's new primary care strategy relies heavily on expanding the role of NPs and PAs in underserved areas. The plan, which was developed after extensive stakeholder engagement, proposes shifting a significant portion of patient encounters from GPs to mid-level providers — a move that the BMA has described as "workforce substitution dressed up as innovation."
Proponents argue that task-shifting is a proven approach in global health systems. The WHO has documented its effectiveness in LMICs, and several high-income countries have expanded scope of practice for non-physician clinicians with positive outcomes for patient throughput and cost-per-encounter metrics.
Critics counter that the evidence base is weaker than proponents suggest. A recent systematic review found that while patient satisfaction scores were comparable, clinical outcomes data was heterogeneous and the studies had significant risk of bias. The review's authors cautioned against extrapolating from controlled pilot programmes to national rollout.
The strategy also includes provisions for integrated care pathways and a new outcomes-based commissioning framework that would tie provider reimbursement to QALYs rather than volume of service. Health economists say this represents a fundamental shift from fee-for-service to value-based care, but implementation will require significant investment in health informatics infrastructure and interoperability standards.
Jargon Report Audience baseline: General newspaper reader
"NPs and PAs" (Para 1) — Acronym → Plain alternative: "nurse practitioners and physician associates" (spell out on first use)
"stakeholder engagement" (Para 1) — Insider language → Plain alternative: "consultation with doctors, nurses, patient groups, and health officials"
"mid-level providers" (Para 1) — Jargon → Plain alternative: "nurses and other non-doctor clinicians" or define briefly on first use
"BMA" (Para 1) — Acronym → Plain alternative: Spell out as "British Medical Association" on first use
"task-shifting" (Para 2) — Jargon → Plain alternative: "moving certain medical tasks from doctors to other qualified health workers"
"LMICs" (Para 2) — Acronym → Plain alternative: "low- and middle-income countries"
"scope of practice" (Para 2) — Jargon → Plain alternative: "the range of procedures and treatments they are allowed to perform"
"patient throughput" (Para 2) — Jargon → Plain alternative: "the number of patients seen"
"cost-per-encounter metrics" (Para 2) — Jargon → Plain alternative: "the cost of each patient visit"
"systematic review" (Para 3) — Jargon → Plain alternative: "a study that analysed all available research on the topic"
"heterogeneous" (Para 3) — Jargon → Plain alternative: "varied and inconsistent"
"risk of bias" (Para 3) — Jargon → Plain alternative: "flaws in how the studies were designed"
"integrated care pathways" (Para 4) — Jargon → Plain alternative: "coordinated treatment plans that connect different parts of the health system"
"outcomes-based commissioning framework" (Para 4) — Jargon → Plain alternative: "a funding model that pays providers based on patient health results"
"QALYs" (Para 4) — Acronym → Plain alternative: "quality-adjusted life years — a measure of how much a treatment improves a patient's health and lifespan"
"fee-for-service" (Para 4) — Jargon → Plain alternative: "paying doctors per appointment or procedure"
"value-based care" (Para 4) — Jargon → Plain alternative: "a model that rewards keeping patients healthy rather than treating them repeatedly"
"health informatics infrastructure" (Para 4) — Jargon → Plain alternative: "digital record-keeping and data-sharing systems"
"interoperability standards" (Para 4) — Jargon → Plain alternative: "rules that allow different computer systems to share patient information"
Accessibility Verdict: This draft is heavily jargon-laden — 19 flagged terms across 280 words, or roughly one inaccessible term every 15 words. The density increases sharply in paragraphs 2 and 4, which read as specialist policy language rather than journalism. For a general newspaper reader, the piece would need substantial de-jargoning; for an informed policy audience, approximately half these terms could be retained with brief definitions on first use.