argumentative-flow SKILL.md skillA

argumentative-flow from seandavi/scriptorium is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add seandavi/scriptorium/argumentative-flow@git:20261020.24e2628

Pins git:20261020.24e2628 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
seandavi/scriptorium
Path
skills/argumentative-flow/SKILL.md
Versions recorded
9
Latest version
git:20261020.24e2628, committed Oct 20, 2026
First version recorded
May 17, 2026
Size
22,024 bytes
Repository stars
3
License
MIT

Improve a manuscript section's logical and argumentative coherence while preserving every citation, statistic, and declared terminology choice. Produces a structural diagnosis, a proposed outline, the revised text with a diff against the source, and a preservation report. Invoke ONLY when the user explicitly asks for argumentative-flow improvement on a specific section.

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

# Argumentative-flow pass

You are running scriptorium's **argumentative-flow** skill. This is a
**transformative** skill — it modifies prose. It is the only v0.1
skill that does. Everything in this prompt exists to keep that
transformation conservative, auditable, and grounded.

## Invocation discipline — read before doing anything else

This skill **must be invoked explicitly** by the user. Never run it
proactively, never run it as a follow-up to another skill's output
without the user re-asking. The reason: the author owns their voice
and their argument structure, and an unrequested rewrite — even a
"helpful" one — is unwelcome. If the user asked for a citation audit
or a reviewer simulation and you can see argumentative-flow problems
in the text, *say so* in the audit output but do not transform the
text.

If the user has not specified a section, ask. The unit of work is one
section at a time (introduction, results, discussion, methods,
abstract, or a named subsection). Single-section scope is what makes
the diff reviewable; a whole-manuscript pass is outside the default
scope (the `single-section-unit` guard below).

## Guards and overrides
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add seandavi/scriptorium/argumentative-flow@sha256:906cc6202c8b44ca

The line at the top of this page pins the label git:20261020.24e2628, 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_6a52lqkqi54jm54c.svg)](https://markdownregistry.com/a/art_6a52lqkqi54jm54c)

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

Versions

The registry has recorded 9 versions of this file, between May 17, 2026 and Oct 20, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261020.24e2628 latest2026-10-20 24e2628 22,024 BA view · diff
git:20261020.ae1cbaa2026-10-20 ae1cbaa 21,845 BA view · diff
git:20261020.78a4dce2026-10-20 78a4dce 19,010 BA view · diff
git:20261020.41c6f942026-10-20 41c6f94 18,970 BA view · diff
git:20260520.2f3d92e2026-05-20 2f3d92e 17,750 BA view · diff
git:20260520.383aed22026-05-20 383aed2 17,701 BA view · diff
git:20260520.341eff22026-05-20 341eff2 13,321 BA view · diff
git:20260520.b22f6852026-05-20 b22f685 13,228 BA view · diff
git:20260517.8b0de032026-05-17 8b0de03 11,916 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 (22024 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

seandavi/scriptorium · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6a52lqkqi54jm54c
GET https://markdownregistry.com/api/v1/resolve?ref=seandavi/scriptorium/argumentative-flow
GET https://markdownregistry.com/api/v1/blob/906cc6202c8b44ca24e25d71c359eb8fb03a2c66ef92bdd59e50984c67632603

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 seandavi/scriptorium

DESIGN.md DESIGN.md file
seandavi/scriptorium · DESIGN.md
git:20261020.0e1d1ae · audit A · 3 stars
author-contribution-audit SKILL.md skill
seandavi/scriptorium · skills/author-contribution-audit/SKILL.md · Audit the manuscript's Author Contributions section against ICMJE's four authorship criteria and CRediT's 14…
git:20261020.1f8453b · audit A · 3 stars
citation-audit SKILL.md skill
seandavi/scriptorium · skills/citation-audit/SKILL.md · Audit existing citations in a manuscript for claim-support alignment, primary-vs-review mismatch, causal overreach, and…
git:20261020.38cee40 · audit A · 3 stars
compression SKILL.md skill
seandavi/scriptorium · skills/compression/SKILL.md · Propose page-limit-driven length reductions on a manuscript section while preserving every citation, every declared…
git:20261020.24e2628 · audit A · 3 stars
desk-rejection-risk SKILL.md skill
seandavi/scriptorium · skills/desk-rejection-risk/SKILL.md · Author-side pre-submission audit that flags triggers likely to result in desk rejection before peer review —…
git:20261020.03cf3ff · audit A · 3 stars
explain SKILL.md skill
seandavi/scriptorium · skills/explain/SKILL.md · Explain scriptorium itself, a named skill, or a named MANUSCRIPT_STATE field. With no argument, gives a whole-system…
git:20261020.3814215 · audit A · 3 stars
figure-text-alignment SKILL.md skill
seandavi/scriptorium · skills/figure-text-alignment/SKILL.md · Audit text-only alignment between figure captions and the body-text sentences that reference them. For every figure…
git:20261020.04bed6a · audit A · 3 stars
gap-finder SKILL.md skill
seandavi/scriptorium · skills/gap-finder/SKILL.md · Identify gaps in existing draft prose — claims under-supported, premises missing, related work not engaged with…
git:20261020.38cee40 · audit A · 3 stars
init SKILL.md skill
seandavi/scriptorium · skills/init/SKILL.md · Conversationally bootstrap MANUSCRIPT_STATE.yaml for a new or existing manuscript directory. Infers what it can from…
git:20261020.8819780 · audit A · 3 stars
outlier-sentence-detector SKILL.md skill
seandavi/scriptorium · skills/outlier-sentence-detector/SKILL.md · Flag sentences that are statistical outliers in the manuscript along three narrow dimensions — length, syntactic…
git:20261020.6122fb3 · audit A · 3 stars
reporting-guideline-compliance SKILL.md skill
seandavi/scriptorium · skills/reporting-guideline-compliance/SKILL.md · Run an EQUATOR Network reporting-guideline checklist (CONSORT, SPIRIT, STROBE, PRISMA, ARRIVE, STARD, TRIPOD/TRIPOD+AI…
git:20261020.04bed6a · audit A · 3 stars
reporting-guideline-fit SKILL.md skill
seandavi/scriptorium · skills/reporting-guideline-fit/SKILL.md · Read the manuscript's methods section (and abstract/title for context) and infer which EQUATOR Network reporting…
git:20261020.4794680 · audit A · 3 stars

Every file in seandavi/scriptorium

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