section-writing-review

Audit academic QMD/TeX paper sections for pedagogical rubric compliance and propose sourced revisions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Academic manuscript sections often fail to follow pedagogical and structural standards, making arguments unclear, methods underspecified, or results misaligned with research questions; this Skill systematically detects those issues and proposes sourced revisions.

Core Features & Use Cases

  • Adversarial review loop: Runs an inquisitor→clarifier→inquisitor pattern to identify foibles, propose sourced revisions, and re-grade the section.
  • Rubric-driven evaluation: Loads section-specific rubrics (intro, data, methods, results, conclusion) and cross-checks adjacent sections for consistency.
  • Safe file handling & outputs: Reads QMD and Overleaf .tex files (read-only for Overleaf), caps rounds/costs, and writes a scored revision file to the project's quality_reports directory.
  • Use Case: Improve a draft results section by locating specification mismatches with methods, proposing structural fixes with citations, and producing a revision-ready QMD audit.

Quick Start

Run a section-writing-review for the data section on the file 3-data.tex to generate a scored revision report.

Frequently Asked Questions about section-writing-review

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

FAQPage Schema
How do I audit an academic paper section against a rubric?

You can audit a paper section by running a pedagogical compliance review that scores structure against rubrics and proposes sourced revisions. The process loads adjacent sections for consistency and outputs a scored revision report.

Can I review Overleaf .tex files for structural compliance?

Yes, you can review Overleaf .tex files in read-only mode to preserve manuscript protection while running structural compliance audits. The Skill processes these files alongside QMD files to evaluate pedagogical standards.

How does peer review revision work for academic manuscripts?

Peer review revision uses an adversarial loop of inquisitor and clarifier agents for up to two rounds with cost caps. The inquisitor identifies foibles, the clarifier proposes sourced revisions, and the section is re-graded.

Does the writing audit check consistency across introduction, methods, and results sections?

Yes, the writing audit checks consistency by loading section-specific rubrics for introduction, data, methods, results, and conclusion sections. It cross-checks adjacent sections to locate specification mismatches.

What is the best way to improve a draft results section with specification mismatches?

The best way to improve a draft results section is to run a compliance audit that locates specification mismatches with methods and proposes structural fixes with citations. This produces a revision-ready QMD audit report.

Where does the structural writing review save revision reports?

The structural writing review saves scored revision files to the project's quality_reports directory. This ensures manuscript protection is preserved while providing revision-ready audit outputs.