draft-slop-fixer

Clean academic drafts by resolving placeholders, matching citations, and rewording notes.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/naj2r/claude-econ-paper-template --skill draft-slop-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draft-slop-fixer
Source: https://github.com/naj2r/claude-econ-paper-template/tree/main/.claude/skills/draft-slop-fixer
Command: npx skills add https://github.com/naj2r/claude-econ-paper-template --skill draft-slop-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the mechanical cleanup of early-stage, stream-of-consciousness academic drafts by resolving placeholder markers, filling citation gaps where possible, rewording copy-paste note dumps to match the author's voice, and delegating unresolved items to downstream agents or the user.

Core Features & Use Cases

  • Identify and classify issues: Finds TODOs, citation placeholders, uncited claims, verbatim note insertions, and structural scaffolding within a draft.
  • Source and patch: Searches project note files and the bibliography for matching content, inserts proper citation keys when available, and marks items that require manual resolution.
  • Non-destructive edits & reporting: Creates timestamped backups, writes cleaned drafts annotated with <!-- SLOP-FIX --> comments, and emits a delegation report listing outstanding tasks for other agents or the user.
  • Use case: An author drops a rough Quarto markdown chapter containing (CITE) and (need more info) markers and receives a cleaned file with matched bib keys, reworded note fragments, and a list of unresolved references.

Quick Start

Run the draft-slop-fixer on your draft file path to produce a cleaned draft, a backup copy, and a delegation report.

Frequently Asked Questions about draft-slop-fixer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up a messy academic draft with TODO markers and uncited claims?

This Skill cleans up messy academic drafts by resolving placeholder markers, matching uncited claims to bibliography entries, and rewording copied notes into your voice. It searches project notes and .bib files to automate early-stage manuscript preparation.

What is the best way to match uncited claims in my manuscript to my .bib file?

The best way to match uncited claims to your .bib file is using this Skill, which searches project bibliography entries and inserts proper citation keys where available. Claims that cannot be matched are marked for manual resolution in a delegation report.

Can I automatically reword copy-pasted notes to match my academic writing voice?

Yes, you can automatically reword copy-pasted notes to match your academic writing voice. The Skill identifies verbatim note insertions within your draft and rephrases them, leaving SLOP-FIX comments to annotate the changes made to the text.

How do I prepare a Quarto markdown chapter with informal citations for peer review?

To prepare a Quarto markdown chapter for review, the Skill processes files containing informal citations and raw note dumps. It produces a cleaned draft with matched bib keys, reworded fragments, and a delegation report listing outstanding unresolved references.

Does fixing stream-of-consciousness drafts modify my original manuscript files?

Fixing stream-of-consciousness drafts does not destructively modify your original manuscript files. The Skill creates timestamped backups before applying any edits, ensuring your original text remains intact while producing a newly cleaned draft.

What should I do with unresolved references and placeholders after automated draft cleanup?

After automated draft cleanup, you should handle unresolved references and placeholders listed in the generated delegation report. This report details outstanding tasks, allowing you or downstream agents to manually resolve items lacking matching bibliography entries.