develop-paper-outline

Builds and validates paper outlines as argument databases with a deterministic checker.

1|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/hideh1231/loopbench --skill develop-paper-outline-hideh1231
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: develop-paper-outline
Source: https://github.com/hideh1231/loopbench/tree/main/plugins/loopbench-research/src/research_core/resources/skills/develop-paper-outline
Command: npx skills add https://github.com/hideh1231/loopbench --skill develop-paper-outline-hideh1231

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Academic papers often fail because prose gets written before the underlying argument is settled, forcing large rewrites when the structure moves. This Skill treats the outline as a structured database of claims, warrants, counterpoints, and boundaries, and audits it with a deterministic checker so argument holes are found before any prose exists. ## Core Features & Use Cases - Argument-first outlining: Separates clerical fields (filled by the agent from chat) from argument fields (claim, warrant, counterpoint, boundary) that only the author can supply, withholding the agent's own draft until the author answers. - Deterministic validation: Runs research-core validate outline.json --kind outline to check containment, fact/opinion tagging, claim strength against a named dictionary, hanging references, extraction provenance, and arrangement, with a documented waiver mechanism. - Reconciliation logging: Records each author-versus-agent reconciliation to a JSONL log and recomputes graduation state every run without ever lowering check severity. - Use Case: A researcher drafting a results section uses the Skill to iteratively answer one question at a time about missing warrants and counterpoints, then runs the checker to confirm every promise is discharged before writing prose. ## Quick Start Ask the agent to start a paper outline audit with the develop-paper-outline skill and run the checker on your outline.json file.

Frequently Asked Questions about develop-paper-outline

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

FAQPage Schema
How do I validate a paper outline before writing the prose?

Run `research-core validate outline.json --kind outline` after installing the package with `uv pip install -e <plugin dir>`. The checker reports errors and warnings in `report.issues` and wording advisories separately, and a clean document has no issues.

What is the difference between clerical and argument fields in an outline?

Clerical fields like id, parent, promises, and locators can be detected by diffing against the draft, so the agent fills them from chat. Argument fields like claim, warrant, counterpoint, and boundary exist only in the author's head, so the author must answer first before the agent shows its own draft.

Does the outline checker require Loopbench to run?

No, Loopbench is optional. The checker runs standalone with Python 3.11 or later via the research-core package, either from the command line or through the Python API using the analyze function.

Can I waive a checker issue that does not apply to my paragraph?

Yes, waive it with a JSON entry containing the code, node, reason, and author name. The issue moves to a waived state carrying the reason rather than disappearing, and a waiver whose target no longer exists is reported as Z011.

What are the limitations of the outline checker?

It does not verify that claims are true, that the study design is adequate, or that the argument will convince reviewers. C103 cannot verify MECE coverage, S402 only detects disagreement with a named dictionary, and E301, E304, and S402 depend on human-assigned epistemic tags.