Skip to content
cccskills
FreePublished on GitHub

paragraph-curator

Deterministically compact final H3 bodies to the active delivery profile's paragraph budget without deleting prose or changing citation-block order.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (2)

  • SKILL.md2.4 KB
  • scripts/run.py6.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Paragraph Curator

Triggers & routing

  • Trigger: paragraph compaction, paragraph budget, compact H3, 段落压缩, 段落预算.
  • Use when: H3 section files have passed logic polish and must converge before the final argument snapshot and merge.

Compact paragraph boundaries without performing a new semantic rewrite.

This is a deterministic convergence step. It prevents a long drafting loop from leaving sections outside the delivery profile, while keeping the original prose and evidence recoverable. It does not rank paragraphs, generate alternatives, replace evidence, or decide which claims are important.

Inputs

  • sections/S<subsection-id>.md
  • queries.md for draft_profile
  • upstream logic and writer reports for operator context

Only H3 files are modified. Front matter (S1.md, S2.md), H2 lead files, and global sections are not touched.

Profile Contract

ProfileParagraphs per H3
course_paper5-7
survey10-12
deep11-13

The script first joins short adjacent body paragraphs while respecting the profile floor. If a section remains over budget, it repeatedly joins the shortest eligible adjacent pair. It never truncates a paragraph or drops a middle block.

Outputs

  • updated H3 files under sections/
  • output/PARAGRAPH_CURATION_REPORT.md
  • sections/paragraphs_curated.refined.ok on PASS

The report records the active profile and before/after paragraph counts for each H3. PASS requires every H3 to be within budget and the sequence of citation blocks to be unchanged. On FAIL, the marker is removed.

Boundaries

  • If an H3 is below the floor, route to subsection-writer or the relevant evidence unit. Compaction must not invent padding.
  • If prose is repetitive or logically weak, route to writer-selfloop or section-logic-polisher. This Skill changes paragraph boundaries, not ideas.
  • Run argument-selfloop after this Skill so the argument ledger and section manifest describe the final section content.

Run

uv run python .codex/skills/paragraph-curator/scripts/run.py \
  --workspace workspaces/<name>

Optional runner fields are --unit-id, --inputs, --outputs, and --checkpoint.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Internal template for creating or refactoring a skill into the repository's reference-first shape. **Trigger**: reference-first template, blueprint skill, create a reusable skill, refactor a script-heavy skill. **Use when**: you need a lean `SKILL.md`, explicit `references/`, machine-readable `assets/`, and a minimal deterministic `run.py`.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

Download a small corpus of open-access arXiv survey/review PDFs about agentic systems and extract text for style learning.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

Extract per-subsection “anchor facts” (NO PROSE) from evidence packs so the writer is forced to include concrete numbers/benchmarks/limitations instead of generic summaries.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

Curate reader-facing survey tables for the Appendix (clean layout + high information density), using only in-scope evidence and existing citation keys.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

Build a final, machine-readable argument snapshot from current H3 sections and refresh section fingerprints before merge.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

Audit one research Workspace for declared Unit outputs and Pipeline target Artifacts, writing `output/CONTRACT_REPORT.md`; use for mid-Run coverage snapshots or final delivery completeness, not deep provenance integrity.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills515Updated Oct 5, 2026

See all skills by WILLOSCAR

Report a problem with this skill