What is paper-discourse-graph?

A review method that treats a LaTeX paper as a chain of reader questions and answers rather than only as an outline. It checks paragraph flow, continuity, explanations, notation timing, and the placement of figures and equations.

Use it to review whether a paper section tells a clear story, whether each paragraph leads naturally to the next, and whether figures or equations appear where readers need them.

It helps reveal abrupt transitions, missing context, unnecessary detours, repetitive writing, and explanations that arrive too late.

paper-discourse-graph — Skill for Claude Code by shubham0704

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add shubham0704/claude-skills --skill paper-discourse-graph

Clone the repo

git clone --depth 1 https://github.com/shubham0704/claude-skills

Made for: Claude Code.

Or install paper-discourse-graph, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/shubham0704/claude-skills/paper-discourse-graph/github.svg)](https://agentmods.dev/skills/shubham0704/claude-skills/paper-discourse-graph)

Your own site

<a href="https://agentmods.dev/skills/shubham0704/claude-skills/paper-discourse-graph"><img src="https://agentmods.dev/badge/skills/shubham0704/claude-skills/paper-discourse-graph/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/shubham0704/claude-skills/paper-discourse-graph"><img src="https://agentmods.dev/badge/skills/shubham0704/claude-skills/paper-discourse-graph.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,741 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00073	$0.01741
Opus 5	$0.00036	$0.00870
Sonnet 5	$0.00015	$0.00348
Haiku 4.5	$0.00007	$0.00174

Measured 11d ago against content hash 79ca7bb1f2d3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

paper-discourse-graph scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

The scan reads SKILL.md. This mod also ships 8 executable files (scripts/discourse_graph_audit.py, scripts/discourse_graph/__init__.py, scripts/discourse_graph/cli.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

paper-discourse-graph/SKILL.md · 199 lines

How it starts

The opening of the file, as written. The whole thing — 199 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Paper Discourse Graph

Use this skill to review a paper section as a reader-state graph, not only as a linear outline. The goal is to see what each paragraph plants, what it pays off, where notation appears before intuition, and where a justification detour interrupts the main story.

1. Workflow

1.1 Establish scope

Identify the source .tex file or section to audit. If the user wants discussion before editing, produce findings and proposed interventions only.

Look for project-local guidance before running a generic pass:

AGENT_REVIEW_BRIEF.md
docs/*review*brief*.md
tools/discourse_graph/profiles/*.json
paper-specific profiles or terminology docs

1.2 Choose a profile

Use the most specific available profile:

user-provided --profile
project-local profile, if present
bundled references/profiles/cphast.json for C-PHAST drafts
bundled references/profiles/default_scientific_paper.json

Profiles define the central reader question, audience needs, domain terms, and topic checks. Keep project taste in profiles, not in the engine.

For methods, theory, or appendix sections where paragraphs hand off to notation and equations, also read references/formal_block_flow.md. When authoring or revising source files and the user wants durable machine-readable breadcrumbs for later passes, read references/source_semantic_comments.md. For late-stage paragraph-by-paragraph refinement, task breakdowns for fresh agents, or requests to zoom into each paragraph with a fresh mind, read references/paragraph_refinement_tasks.md.

1.3 Run the CLI

From this skill directory:

python scripts/discourse_graph_audit.py <source.tex> \
  --section <stable-id> \
  --profile references/profiles/default_scientific_paper.json \
  --out <report.md> \
  --json-out <graph.json>

For C-PHAST:

python scripts/discourse_graph_audit.py paper/sec/3_method_arxiv.tex \
  --section 3 \
  --profile references/profiles/cphast.json \
  --out paper/docs/plans/discourse_graph_sec3.md \
  --json-out paper/docs/plans/discourse_graph_sec3.json

Read the full file on GitHub · 199 lines

Files

What ships with it

15 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

11d ago First seen · 199 lines · 73 tokens per session scan A 79ca7bb1f2d3

Subscribe to this mod's changes

paper-discourse-graph is a skill published in the GitHub repository shubham0704/claude-skills (1 stars, last pushed 6d ago), licensed MIT. It adds 73 tokens to every session and 1,741 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code Scientific Writing and docs academic-writing agentic-skills ai-tools claude-skills codex

thesis-control

Use when AI-assisted thesis or manuscript edits risk claim drift, scope creep, loss of intended use, experiment-role promotion, or repeated revisions that fail to converge; provides author-intent control, lightweight or strict contracts, drift audits, revision escalation, and human gates.

yha9806/academic-writing-toolkit · 57 tokens

manuscript-reframe

Reframe report-like academic drafts into paper-form scientific arguments while preserving or explicitly renegotiating author intent; requires an approved old-versus-proposed spine, evidence and argument baselines, analysis-role control, and post-edit drift review.

yha9806/academic-writing-toolkit · 53 tokens

paper-writer

Medical/scientific paper writing workflow skill. Manages the full pipeline from literature search to submission-ready manuscript. Creates and manages a project directory with IMRAD-format section files, literature matrix, reference management, and quality checklists. Supports both English and Japanese papers.…

kgraph57/paper-writer-skill · 106 tokens

food-research

Run a comprehensive, multi-source literature and evidence-synthesis workflow for food & nutrition science. Use when the user wants to research a food/nutrition topic in depth, do a literature review, build an evidence brief, screen and synthesize many sources, verify citations, or scope a systematic review.…

PangenomeAI/academic-skills-food-nutrition · 154 tokens

food-paper

Multi-subagent manuscript system for food & nutrition science covering the whole research process: understand the field, frame research questions, curate and analyze data, run statistics, build figures and tables, construct the discussion, draft, polish, and self-review — journal-aware throughout. Includes a…

PangenomeAI/academic-skills-food-nutrition · 180 tokens

food-pipeline

Master orchestrator for the whole food & nutrition research-to-publication workflow. Coordinates the specialist skills — each with its own subagent set — into one governed path: journal selection, research (food-research / food-deep-research), writing & analysis (food-paper), figures (food-figure), peer review…

PangenomeAI/academic-skills-food-nutrition · 137 tokens