Section Logic Polisher

What it does

The Section Logic Polisher refines Markdown sections to improve their logical flow and readability, specifically addressing issues that create a “paper feel” even in detailed content. It focuses on ensuring each subsection presents a clear argument with a strong thesis statement and well-connected paragraphs. This skill helps ensure the first paragraph of a section explicitly states its claim (thesis) and that transitions between paragraphs are substantive rather than just connectors.

When to use it

• After drafting a long, citation-dense Markdown subsection.
• When a subsection lacks a clear thesis statement in the opening paragraph.
• To improve the flow of arguments within a section by strengthening connections between paragraphs.
• As part of a review process before merging content.
• When sections feel disjointed or like "paragraph islands."

Key capabilities

• Thesis Statement Enforcement: Ensures the first paragraph ends with an explicit, clear thesis statement (content claim).
• Logical Flow Enhancement: Improves connections between paragraphs to create a cohesive argument.
• Content-Bearing Bridges: Rewrites empty transitions into substantive bridges that advance the argument (contrast, causation, implication).
• Focus on Existing Content: Does not add new citations or invent facts; it refines existing content.
• Uses Contextual Information: Leverages outline/subsection_briefs.jsonl and optionally outline/writer_context_packs.jsonl to guide the polishing process, incorporating intended thesis statements and paragraph plans.

Example prompts

While this skill operates as a local polish step rather than responding directly to prompts, relevant context can be provided through input files:

• "Polish section S<sec>_<sub>.md using the intent from outline/subsection_briefs.jsonl."
• "Refine section S<sec>_<sub>.md, prioritizing must_use anchors and constraints from outline/writer_context_packs.jsonl."

Tips & gotchas

• Prerequisite: This skill is best used after a draft has been created. It's not designed to generate content from scratch.
• Focus: The tool specifically targets thesis statements and paragraph bridges; it does not address redundancy or overall section length (use "paragraph-curator" for that).
• Connector Word Counts as Signals: While connector word counts are tracked, avoid forcing a specific number of connectors, as this can lead to unnatural writing. Treat these numbers as diagnostic indicators rather than goals.