segment-paper

Partition a normalized academic paper into ordered, semantically coherent reading chunks with full source coverage.

4|Updated May 20, 2024
One-click install
npx skills add https://github.com/SpreadZhao/spreadconfig --skill segment-paper-spreadzhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: segment-paper
Source: https://github.com/SpreadZhao/spreadconfig/tree/main/plugins/paper-reading-workbench/skills/segment-paper
Command: npx skills add https://github.com/SpreadZhao/spreadconfig --skill segment-paper-spreadzhao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Academic papers are too long to read or analyze in one pass, and naive splitting breaks claims away from their evidence, equations, or figures. This Skill partitions an ingested paper into contiguous, ordered chunks that each contain one complete argument unit while guaranteeing no source block is lost, duplicated, or reordered. ## Core Features & Use Cases - Semantic Chunking: Walks source blocks in order and groups each claim with its direct justification, equation derivation, figure/table evidence, or qualification. - Coverage Validation: Flattens all chunk source-block lists and verifies they exactly match the source map IDs in order, rejecting omissions, duplicates, and orphaned headings. - Structured Output: Writes one Markdown file per chunk under 01 Chunks/ with frontmatter metadata (role, pages, dependencies, assets), plus chunk-map.json and a readable index. - Use Case: After ingesting a research paper into a reading workbench, run this Skill to rebuild poor chunks so each chunk focuses on a single argument unit before handing them to a reader for sequential study. ## Quick Start Use the segment-paper skill to partition the ingested paper into ordered semantic chunks and validate complete source-block coverage.

Frequently Asked Questions about segment-paper

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

FAQPage Schema
How do I split an academic paper into semantic chunks?

Run this Skill after ingestion completes. It walks the source blocks in order, groups each claim with its direct evidence, and writes one Markdown file per chunk under 01 Chunks/ plus a chunk-map.json index.

How to chunk a research paper without losing figures or equations?

The chunking contract keeps each figure or table with its caption and interpreting paragraph, and each equation with its variable definitions. Validation rejects any chunk that separates a claim from its direct evidence or displayed equation.

Can I run paper segmentation before ingestion is complete?

No. The Skill requires ingest=complete and reads paper.md, source-map.json, and the extraction report in full before segmenting. Running it earlier risks missing or misordered source blocks.

Does the chunker enforce a fixed chunk size or token count?

No. It preserves semantic integrity over equal sizes, using one or more complete paragraphs per chunk. Chunks combined only to reach a preferred size are explicitly rejected during validation.

Why does chunk validation fail after segmentation?

Validation fails when flattened chunk source-block lists do not equal the source map IDs exactly and in order. Common causes include omitted, duplicated, reordered, or unknown blocks, and headings orphaned from the material they introduce.