paper-discourse-graph SKILL.md skillA

paper-discourse-graph from shubham0704/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shubham0704/claude-skills/paper-discourse-graph@v0.1.5

Pins v0.1.5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shubham0704/claude-skills
Path
paper-discourse-graph/SKILL.md
Versions recorded
3
Latest version
v0.1.5, committed Oct 1, 2026
First version recorded
Jun 11, 2026
Size
9,875 bytes
Repository stars
2
License
MIT

Audit LaTeX papers as discourse graphs when paragraph flow, story continuity, readability, reader-state breadcrumbs, payoff chains, appendix/supplement structure, or figure/equation placement matter. Use when the user asks whether a section feels abrupt, wasteful, machine-generated, monotonous, hard to parse, or wants to zoom in/out across paragraphs before editing; also use for GRE-style paragraph logic checks such as topic promise, paragraph unity, sentence-to-sentence coherence…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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 Check the whole argument before local polish

For a paper-level revision, connect the opening question to the proposed insight,
the mechanism, and the exact evidence that answers it. For a narrow edit, inspect
only the relevant part of that chain. Distinguish three cases:

- **Exposition gap:** the answer exists but its placement or explanation hides it.
- **Evidence gap:** the paper has not yet answered the question; prose cannot close it.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shubham0704/claude-skills/paper-discourse-graph@sha256:8af13ed9b9671e80

The line at the top of this page pins the label v0.1.5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_aodpsxu2tg5xwcie.svg)](https://markdownregistry.com/a/art_aodpsxu2tg5xwcie)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jun 11, 2026 and Oct 1, 2026, about one every 56 days.

versioncommittedcommitsizeaudit
v0.1.5 latest2026-10-01 b885f69 9,875 BA view · diff
v0.1.42026-06-11 1bd9afc 7,745 BA view · diff
v0.1.02026-06-11 1714770 5,312 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9875 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shubham0704/claude-skills · 2 stars · license MIT · pushed 2026-10-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_aodpsxu2tg5xwcie
GET https://markdownregistry.com/api/v1/resolve?ref=shubham0704/claude-skills/paper-discourse-graph
GET https://markdownregistry.com/api/v1/blob/8af13ed9b9671e80d661588acc7e22375ca0b3adf14e1346dfc5dd9ecfbee89e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shubham0704/claude-skills

animating-computational-mechanics SKILL.md skill
shubham0704/claude-skills · animating-computational-mechanics/SKILL.md · Animate continuum mechanics, tensor calculus, and finite element concepts — deformation gradients, polar decomposition…
v0.1.0 · audit A · 2 stars
_template SKILL.md skill
shubham0704/claude-skills · docs/skill-template/SKILL.md · One-line WHAT this skill does + two to three sentences on WHEN to trigger it. Be specific about contexts and use a…
v0.1.0 · audit A · 2 stars
enhancing-latex-lectures SKILL.md skill
shubham0704/claude-skills · enhancing-latex-lectures/SKILL.md · Enhances LaTeX lecture notes by analyzing pedagogical reference materials (like Todorov's PDFs) and systematically…
git:20260415.c99c9bb · audit A · 2 stars
explain-systems-visually SKILL.md skill
shubham0704/claude-skills · explain-systems-visually/SKILL.md · Create or revise technical teaching slides and visual walkthroughs with prerequisite-aware progression, explicit inputs…
git:20261001.b885f69 · audit A · 2 stars
plan-to-dag SKILL.md skill
shubham0704/claude-skills · plan-to-dag/SKILL.md · Convert large multistep plans, implementation roadmaps, architecture plans, migration plans, or vague next-step…
git:20260511.f95feee · audit A · 2 stars
reader-comprehension-pass SKILL.md skill
shubham0704/claude-skills · reader-comprehension-pass/SKILL.md · Make technical writing land with its reader — add figures for hard-to-grasp concepts, define jargon in plain terms at…
git:20261001.b885f69 · audit A · 2 stars
refining-ml-papers SKILL.md skill
shubham0704/claude-skills · refining-ml-papers/SKILL.md · Refines ML/scientific LaTeX papers based on reviewer or advisor feedback. Handles structural reorganization (moving…
git:20261008.62cbee6 · audit A · 2 stars
rigorous-paper-author SKILL.md skill
shubham0704/claude-skills · rigorous-paper-author/SKILL.md · Draft or revise a mathematically rigorous LaTeX research paper for theory-heavy ML, scientific computing, numerical…
git:20261008.62cbee6 · audit A · 2 stars
rigorous-paper-reviewer SKILL.md skill
shubham0704/claude-skills · rigorous-paper-reviewer/SKILL.md · Review a LaTeX research paper for mathematical rigor, notation consistency, proof obligations, numerical-analysis…
git:20261008.62cbee6 · audit A · 2 stars
rpi-workflow SKILL.md skill
shubham0704/claude-skills · rpi-workflow/SKILL.md · Research-Plan-Implement workflow with Codex peer review. Use when the user says /rpi, asks to start a…
git:20260416.ce62f35 · audit A · 2 stars
tikz-figure-review SKILL.md skill
shubham0704/claude-skills · tikz-figure-review/SKILL.md · Review and fix alignment, label collision, clipping, legend-over-data, overlap, and layout issues in TikZ and pgfplots…
v1.0.0 · audit A · 2 stars

Every file in shubham0704/claude-skills

Browse by kind, by grade A, or by owner.