paperlint 3.2.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +2 -2
- package/dist/adapters/banal/failure.d.ts +1 -7
- package/dist/adapters/banal/failure.d.ts.map +1 -1
- package/dist/adapters/banal/failure.js +5 -7
- package/dist/adapters/banal/failure.js.map +1 -1
- package/dist/adapters/banal/index.d.ts.map +1 -1
- package/dist/adapters/banal/index.js +8 -11
- package/dist/adapters/banal/index.js.map +1 -1
- package/dist/adapters/banal/install.d.ts.map +1 -1
- package/dist/adapters/banal/install.js +4 -3
- package/dist/adapters/banal/install.js.map +1 -1
- package/dist/adapters/banal/invocation.d.ts +9 -4
- package/dist/adapters/banal/invocation.d.ts.map +1 -1
- package/dist/adapters/banal/invocation.js +13 -1
- package/dist/adapters/banal/invocation.js.map +1 -1
- package/dist/adapters/banal/locate.d.ts +12 -9
- package/dist/adapters/banal/locate.d.ts.map +1 -1
- package/dist/adapters/banal/locate.js +19 -12
- package/dist/adapters/banal/locate.js.map +1 -1
- package/dist/adapters/banal/run.d.ts +10 -1
- package/dist/adapters/banal/run.d.ts.map +1 -1
- package/dist/adapters/banal/run.js +8 -4
- package/dist/adapters/banal/run.js.map +1 -1
- package/dist/adapters/banal/settings.d.ts +1 -1
- package/dist/adapters/banal/settings.d.ts.map +1 -1
- package/dist/adapters/banal/settings.js +2 -1
- package/dist/adapters/banal/settings.js.map +1 -1
- package/dist/adapters/memory/index.d.ts.map +1 -1
- package/dist/adapters/memory/index.js +8 -2
- package/dist/adapters/memory/index.js.map +1 -1
- package/dist/adapters/node/process.io.d.ts +6 -3
- package/dist/adapters/node/process.io.d.ts.map +1 -1
- package/dist/adapters/node/process.io.js.map +1 -1
- package/dist/adapters/node/workspace.io.d.ts.map +1 -1
- package/dist/adapters/node/workspace.io.js +4 -2
- package/dist/adapters/node/workspace.io.js.map +1 -1
- package/dist/adapters/references/index.d.ts.map +1 -1
- package/dist/adapters/references/index.js +4 -2
- package/dist/adapters/references/index.js.map +1 -1
- package/dist/build-engine.d.ts +1 -1
- package/dist/build-engine.d.ts.map +1 -1
- package/dist/build-engine.js +8 -1
- package/dist/build-engine.js.map +1 -1
- package/dist/build.d.ts +2 -3
- package/dist/build.d.ts.map +1 -1
- package/dist/build.js +5 -6
- package/dist/build.js.map +1 -1
- package/dist/caller-path.d.ts +3 -0
- package/dist/caller-path.d.ts.map +1 -0
- package/dist/caller-path.js +13 -0
- package/dist/caller-path.js.map +1 -0
- package/dist/cli.d.ts +10 -17
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +62 -12
- package/dist/cli.js.map +1 -1
- package/dist/doctor.d.ts +12 -3
- package/dist/doctor.d.ts.map +1 -1
- package/dist/doctor.js +2 -1
- package/dist/doctor.js.map +1 -1
- package/dist/domain/paths.d.ts +8 -2
- package/dist/domain/paths.d.ts.map +1 -1
- package/dist/domain/paths.js +12 -1
- package/dist/domain/paths.js.map +1 -1
- package/dist/domain/ready.d.ts +24 -0
- package/dist/domain/ready.d.ts.map +1 -0
- package/dist/domain/ready.js +11 -0
- package/dist/domain/ready.js.map +1 -0
- package/dist/domain/record.d.ts +8 -0
- package/dist/domain/record.d.ts.map +1 -0
- package/dist/domain/record.js +8 -0
- package/dist/domain/record.js.map +1 -0
- package/dist/domain/sha256.d.ts.map +1 -1
- package/dist/domain/sha256.js +4 -2
- package/dist/domain/sha256.js.map +1 -1
- package/dist/engine.d.ts +23 -22
- package/dist/engine.d.ts.map +1 -1
- package/dist/engine.js.map +1 -1
- package/dist/eslint-rules/bib-reachable-entry.d.ts +1 -1
- package/dist/eslint-rules/bib-reachable-entry.js.map +1 -1
- package/dist/eslint-rules/install-path-literals.d.ts +2 -2
- package/dist/eslint-rules/install-path-literals.js.map +1 -1
- package/dist/eslint-rules/paper-research-question.d.ts +1 -1
- package/dist/eslint-rules/paper-research-question.js.map +1 -1
- package/dist/eslint-rules/paper-stages.d.ts +2 -2
- package/dist/eslint-rules/paper-stages.js.map +1 -1
- package/dist/eslint-rules/paper-typography.d.ts +6 -6
- package/dist/eslint-rules/paper-typography.js.map +1 -1
- package/dist/eslint-rules/pdf-last-page-balance.d.ts +1 -1
- package/dist/eslint-rules/pdf-last-page-balance.js.map +1 -1
- package/dist/eslint-rules/review-frontmatter.d.ts +2 -2
- package/dist/eslint-rules/review-frontmatter.js.map +1 -1
- package/dist/eslint-rules/sibling-frontmatter.d.ts +1 -1
- package/dist/eslint-rules/sibling-frontmatter.d.ts.map +1 -1
- package/dist/eslint-rules/temp-root-realpath.d.ts +1 -1
- package/dist/eslint-rules/temp-root-realpath.js.map +1 -1
- package/dist/eslint-rules/tex-build.d.ts +2 -2
- package/dist/eslint-rules/tex-build.js.map +1 -1
- package/dist/facts-file.d.ts.map +1 -1
- package/dist/facts-file.js +29 -26
- package/dist/facts-file.js.map +1 -1
- package/dist/hooks-settings.d.ts.map +1 -1
- package/dist/hooks-settings.js +17 -2
- package/dist/hooks-settings.js.map +1 -1
- package/dist/init.d.ts +3 -4
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +18 -8
- package/dist/init.js.map +1 -1
- package/dist/lib/paper-config.d.ts.map +1 -1
- package/dist/lib/paper-config.js +1 -5
- package/dist/lib/paper-config.js.map +1 -1
- package/dist/new-paper.d.ts.map +1 -1
- package/dist/new-paper.js +5 -1
- package/dist/new-paper.js.map +1 -1
- package/dist/paper-files.d.ts +4 -4
- package/dist/paper-files.d.ts.map +1 -1
- package/dist/paper-files.js +6 -6
- package/dist/paper-files.js.map +1 -1
- package/dist/paper-settings.js +3 -3
- package/dist/paper-settings.js.map +1 -1
- package/dist/pdf-facts.d.ts +51 -1
- package/dist/pdf-facts.d.ts.map +1 -1
- package/dist/pdf-facts.js +23 -15
- package/dist/pdf-facts.js.map +1 -1
- package/dist/pdf-geometry.d.ts.map +1 -1
- package/dist/pdf-geometry.js +2 -3
- package/dist/pdf-geometry.js.map +1 -1
- package/dist/ports/tool-installer.d.ts +2 -14
- package/dist/ports/tool-installer.d.ts.map +1 -1
- package/dist/presets.d.ts.map +1 -1
- package/dist/presets.js +16 -4
- package/dist/presets.js.map +1 -1
- package/dist/references.d.ts.map +1 -1
- package/dist/references.js +4 -4
- package/dist/references.js.map +1 -1
- package/dist/rules-config.d.ts +26 -1
- package/dist/rules-config.d.ts.map +1 -1
- package/dist/rules-config.js +9 -9
- package/dist/rules-config.js.map +1 -1
- package/dist/tex-requirements.d.ts +4 -0
- package/dist/tex-requirements.d.ts.map +1 -1
- package/dist/tex-requirements.js +14 -2
- package/dist/tex-requirements.js.map +1 -1
- package/dist/types.d.ts +5 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/venue-rules.d.ts.map +1 -1
- package/dist/venue-rules.js +20 -7
- package/dist/venue-rules.js.map +1 -1
- package/docs/configuration.md +2 -2
- package/eslint-rules/bib-reachable-entry.ts +1 -1
- package/eslint-rules/install-path-literals.ts +2 -2
- package/eslint-rules/paper-research-question.ts +1 -1
- package/eslint-rules/paper-stages.ts +2 -2
- package/eslint-rules/paper-typography.ts +2 -2
- package/eslint-rules/pdf-last-page-balance.ts +1 -1
- package/eslint-rules/review-frontmatter.ts +1 -1
- package/eslint-rules/temp-root-realpath.ts +1 -1
- package/eslint-rules/tex-build.ts +2 -2
- package/eslint.config.mjs +7 -0
- package/fixtures/install-path-literals/clean.fixture.mjs +1 -1
- package/fixtures/install-path-literals/clean.md +2 -2
- package/fixtures/install-path-literals/defect.fixture.mjs +1 -1
- package/fixtures/install-path-literals/defect.md +2 -2
- package/hooks/paper-status-gates.sh +9 -19
- package/lib/paper-config.harness.mjs +1 -1
- package/lib/paper-config.ts +1 -5
- package/lib/skill-checks.mjs +24 -381
- package/lib/skill-checks.test.mjs +63 -115
- package/lib/skill-corpus.mjs +10 -251
- package/lib/skill-corpus.test.mjs +2 -13
- package/lib/skill-trigger-cases.mjs +1 -1
- package/package.json +1 -1
- package/scripts/coverage-config.test.ts +0 -1
- package/scripts/harness-api.frozen.json +0 -1
- package/skills/analyze-sibling-paper/SKILL.md +1 -39
- package/skills/analyze-sibling-paper/SKILL.md.spec.ts +0 -38
- package/skills/argument-arc/SKILL.md +2 -36
- package/skills/argument-arc/SKILL.md.spec.ts +1 -43
- package/skills/build-benchmark/SKILL.md +1 -41
- package/skills/build-benchmark/SKILL.md.spec.ts +0 -40
- package/skills/camera-ready/SKILL.md +1 -34
- package/skills/camera-ready/SKILL.md.spec.ts +0 -33
- package/skills/cold-read-diff/SKILL.md +1 -35
- package/skills/cold-read-diff/SKILL.md.spec.ts +0 -34
- package/skills/draft-paper/SKILL.md +2 -41
- package/skills/draft-paper/SKILL.md.spec.ts +1 -50
- package/skills/extend-paper/SKILL.md +2 -33
- package/skills/extend-paper/SKILL.md.spec.ts +1 -42
- package/skills/find-venue/SKILL.md +2 -38
- package/skills/find-venue/SKILL.md.spec.ts +1 -47
- package/skills/grade-paper-writing/SKILL.md +3 -38
- package/skills/grade-paper-writing/SKILL.md.spec.ts +2 -47
- package/skills/grade-paper-writing/prose-lint.mjs +2 -3
- package/skills/grade-paper-writing/prose-lint.test.ts +1 -1
- package/skills/harden-paper/SKILL.md +1 -39
- package/skills/harden-paper/SKILL.md.spec.ts +0 -38
- package/skills/map-prior-work/SKILL.md +1 -35
- package/skills/map-prior-work/SKILL.md.spec.ts +0 -34
- package/skills/osf-artifact-upload/osf-artifact-upload.harness.ts +3 -4
- package/skills/paper-adversarial-review/SKILL.md +2 -35
- package/skills/paper-adversarial-review/SKILL.md.spec.ts +1 -43
- package/skills/paper-pipeline/SKILL.md +2 -28
- package/skills/paper-pipeline/SKILL.md.spec.ts +1 -27
- package/skills/paper-pipeline/grade-paper-writing-ablation.eval.mjs +1 -1
- package/skills/paper-pipeline/paper-pipeline.harness.mjs +25 -40
- package/skills/paper-pipeline/references/acceptance-gate.md +1 -6
- package/skills/paper-pipeline/references/pipeline-status-template.md +8 -35
- package/skills/paper-pipeline/scripts/README.md +30 -225
- package/skills/paper-pipeline/scripts/artifact-coverage.harness.mjs +4 -8
- package/skills/paper-pipeline/scripts/consumer.harness.mjs +6 -104
- package/skills/paper-pipeline/scripts/consumer.mjs +23 -104
- package/skills/paper-pipeline/scripts/generated-code.harness.mjs +2 -3
- package/skills/paper-pipeline/scripts/population-map.harness.mjs +3 -3
- package/skills/paper-status/SKILL.md +2 -42
- package/skills/paper-status/SKILL.md.spec.ts +1 -41
- package/skills/pc-panel-review/SKILL.md +2 -46
- package/skills/pc-panel-review/SKILL.md.spec.ts +1 -45
- package/skills/plan-paper-timeline/SKILL.md +2 -36
- package/skills/plan-paper-timeline/SKILL.md.spec.ts +0 -36
- package/skills/render-paper/SKILL.md +1 -37
- package/skills/render-paper/SKILL.md.spec.ts +0 -36
- package/skills/research-ideate/SKILL.md +2 -39
- package/skills/research-ideate/SKILL.md.spec.ts +1 -47
- package/skills/study-accepted-papers/SKILL.md +1 -34
- package/skills/study-accepted-papers/SKILL.md.spec.ts +0 -33
- package/skills/submit-paper/SKILL.md +1 -33
- package/skills/submit-paper/SKILL.md.spec.ts +0 -32
- package/skills/sweep-design-space/SKILL.md +1 -38
- package/skills/sweep-design-space/SKILL.md.spec.ts +0 -37
- package/skills/tighten-paper/SKILL.md +2 -39
- package/skills/tighten-paper/SKILL.md.spec.ts +1 -47
- package/skills/tighten-paper/structure.mjs +4 -11
- package/skills/verify-citations/SKILL.md +2 -38
- package/skills/verify-citations/SKILL.md.spec.ts +1 -37
- package/src/adapters/banal/failure.ts +9 -10
- package/src/adapters/banal/index.test.ts +2 -2
- package/src/adapters/banal/index.ts +8 -10
- package/src/adapters/banal/install.ts +9 -4
- package/src/adapters/banal/invocation.test.ts +20 -8
- package/src/adapters/banal/invocation.ts +23 -8
- package/src/adapters/banal/locate.test.ts +2 -2
- package/src/adapters/banal/locate.ts +27 -21
- package/src/adapters/banal/run.test.ts +2 -2
- package/src/adapters/banal/run.ts +16 -10
- package/src/adapters/banal/settings.ts +2 -2
- package/src/adapters/curl/download.test.ts +4 -4
- package/src/adapters/memory/index.ts +4 -3
- package/src/adapters/node/files.test.ts +5 -3
- package/src/adapters/node/process.io.ts +9 -2
- package/src/adapters/node/process.test.ts +4 -4
- package/src/adapters/node/workspace.io.ts +9 -4
- package/src/adapters/references/index.ts +7 -2
- package/src/build-engine.test.ts +11 -6
- package/src/build-engine.ts +10 -5
- package/src/build.test.ts +10 -11
- package/src/build.ts +8 -9
- package/src/caller-path.ts +13 -0
- package/src/cli.harness.mjs +0 -2
- package/src/cli.test.ts +19 -8
- package/src/cli.ts +82 -25
- package/src/doctor.test.ts +1 -1
- package/src/doctor.ts +14 -5
- package/src/domain/paths.test.ts +15 -0
- package/src/domain/paths.ts +20 -1
- package/src/domain/ready.ts +31 -0
- package/src/domain/record.test.ts +20 -0
- package/src/domain/record.ts +12 -0
- package/src/domain/sha256.ts +5 -3
- package/src/engine.ts +30 -2
- package/src/facts-file.ts +43 -28
- package/src/hooks-settings.harness.ts +17 -0
- package/src/hooks-settings.ts +28 -4
- package/src/init.test.ts +25 -5
- package/src/init.ts +26 -12
- package/src/new-paper.harness.mjs +7 -23
- package/src/new-paper.ts +7 -3
- package/src/paper-files.test.ts +22 -19
- package/src/paper-files.ts +16 -27
- package/src/paper-settings.test.ts +2 -2
- package/src/paper-settings.ts +5 -5
- package/src/pdf-facts.test.ts +16 -5
- package/src/pdf-facts.ts +79 -22
- package/src/pdf-geometry.ts +5 -3
- package/src/ports/tool-installer.ts +2 -17
- package/src/presets.ts +28 -14
- package/src/references.test.ts +25 -19
- package/src/references.ts +4 -5
- package/src/rules-config.ts +40 -11
- package/src/tex-requirements.test.ts +21 -0
- package/src/tex-requirements.ts +29 -6
- package/src/toolchain.test.ts +9 -5
- package/src/toolchain.ts +2 -2
- package/src/types.ts +5 -3
- package/src/venue-rules.test.ts +8 -4
- package/src/venue-rules.ts +21 -11
- package/skills/paper-pipeline/scripts/announce.mjs +0 -67
- package/skills/paper-pipeline/scripts/announce.test.mjs +0 -102
- package/skills/paper-pipeline/scripts/fixtures/clean/PIPELINE-STATUS.md +0 -51
- package/skills/paper-pipeline/scripts/fixtures/dirty/PIPELINE-STATUS.md +0 -52
- package/skills/paper-pipeline/scripts/fixtures/dirty/paper.md +0 -6
- package/skills/paper-pipeline/scripts/fixtures/scorecard.ts +0 -100
- package/skills/paper-pipeline/scripts/ledger.cli.test.mjs +0 -302
- package/skills/paper-pipeline/scripts/ledger.mjs +0 -623
- package/skills/paper-pipeline/scripts/ledger.test.mjs +0 -254
- package/skills/paper-pipeline/scripts/pipeline-check.cli.test.mjs +0 -474
- package/skills/paper-pipeline/scripts/pipeline-check.harness.mjs +0 -328
- package/skills/paper-pipeline/scripts/pipeline-check.mjs +0 -750
- package/skills/paper-pipeline/scripts/pipeline-edges.mjs +0 -169
- package/skills/paper-pipeline/scripts/pipeline-edges.test.mjs +0 -73
- package/skills/paper-pipeline/scripts/run-mechanical.mjs +0 -648
- package/skills/paper-pipeline/scripts/run-mechanical.test.mjs +0 -468
- package/skills/paper-pipeline/scripts/status.mjs +0 -295
- package/skills/paper-pipeline/scripts/status.test.mjs +0 -232
|
@@ -24,20 +24,6 @@ export default experimental_skill({
|
|
|
24
24
|
body: `
|
|
25
25
|
# analyze-sibling-paper — settle "isn't this just X?" before a reviewer does
|
|
26
26
|
|
|
27
|
-
## Run me
|
|
28
|
-
|
|
29
|
-
🔴 FIRST, before any other step:
|
|
30
|
-
|
|
31
|
-
\`\`\`
|
|
32
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs analyze-sibling-paper <paper-dir>
|
|
33
|
-
\`\`\`
|
|
34
|
-
|
|
35
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
36
|
-
state — so starting is an event, and events get written down.
|
|
37
|
-
|
|
38
|
-
The \`<paper-dir>\` argument is **your** paper, not the sibling — the row belongs to the paper being
|
|
39
|
-
defended. The sibling is named by \`<report-path>\` when the verdict is recorded.
|
|
40
|
-
|
|
41
27
|
When a paper close to yours surfaces, the wrong move is to cite it from its abstract and move on — that
|
|
42
28
|
leaves a scoop risk you can't see and a reviewer can. This skill reads the *actual* competitor, judges
|
|
43
29
|
whether your contribution genuinely differs, and produces a saved analysis with concrete action points
|
|
@@ -129,30 +115,6 @@ and the action points (with the exact clause text to add/replace). Per the save-
|
|
|
129
115
|
analysis that lives only in a chat is lost the moment the session ends — and it's exactly what you'll need
|
|
130
116
|
again at rebuttal. **A close sibling with no file in \`<paper-dir>/siblings/\` is an unfinished analysis.**
|
|
131
117
|
|
|
132
|
-
## Record the verdict
|
|
133
|
-
|
|
134
|
-
🔴 LAST step, once the deliverable exists:
|
|
135
|
-
|
|
136
|
-
\`\`\`
|
|
137
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record analyze-sibling-paper <paper-dir> FINDING <count> <report-path>
|
|
138
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record analyze-sibling-paper <paper-dir> ABSTAINED <reason> "<one line>"
|
|
139
|
-
\`\`\`
|
|
140
|
-
|
|
141
|
-
**FINDING** — \`<count>\` is the number of action points the card produced (positioning clauses plus
|
|
142
|
-
*MUST CITE* entries), \`<report-path>\` is the saved card, which names the sibling. Add \`--blocking\`
|
|
143
|
-
for a genuine scoop, which the skill already treats as an escalation rather than a clause.
|
|
144
|
-
**ABSTAINED** — \`no-witness\`: the sibling was read in full and the delta needs no text to change.
|
|
145
|
-
\`blocked\`: the sibling's full text could not be obtained, so only its abstract was seen — which is
|
|
146
|
-
explicitly not an analysis and must never be recorded as one.
|
|
147
|
-
|
|
148
|
-
🔴 **There is no PASS.** "The delta is real" read identically whether the sibling had been read
|
|
149
|
-
whole or skimmed, and this skill's own first rule is that an abstract-only delta is not a verdict.
|
|
150
|
-
\`no-witness\` and \`blocked\` now say which happened.
|
|
151
|
-
|
|
152
|
-
One row per sibling analysed, filed under its own \`--check=<sibling-slug>\`; several finding rows
|
|
153
|
-
against one paper is the normal shape here, not a check that keeps failing. Before 2026-08-10 they
|
|
154
|
-
would have overwritten one another.
|
|
155
|
-
|
|
156
118
|
## Rules
|
|
157
119
|
- **Read the paper, not the abstract.** An abstract-only "delta" is not a verdict — and the card must
|
|
158
120
|
say so: \`read: abstract\` in its frontmatter, and which parts in its \`**Read:**\` line.
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: argument-arc
|
|
3
3
|
description: Build or repair the paper's argument architecture — the one-sentence-per-section outline, the bottom-up inevitability pass, and the name/number budget. Run it when the reader says the paper throws ideas at them, when a structural objection repeats, or before any large rewrite. Not a prose or length skill.
|
|
4
|
-
allowed-tools: [Read, Write, Grep, Glob, Agent
|
|
4
|
+
allowed-tools: [Read, Write, Grep, Glob, Agent]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
<!-- vigiles:sha256:
|
|
7
|
+
<!-- vigiles:sha256:66be3161e5bde916 compiled from skills/argument-arc/SKILL.md.spec.ts -->
|
|
8
8
|
|
|
9
9
|
# argument-arc — does the paper carry the reader to one conclusion
|
|
10
10
|
|
|
@@ -14,17 +14,6 @@ allowed-tools: [Read, Write, Grep, Glob, Agent, Bash(node .claude/skills/paper-p
|
|
|
14
14
|
> whether the argument exists. Run it *before* them — cutting words inside a broken arc is how a
|
|
15
15
|
> session burns a day and ships the same paper.
|
|
16
16
|
|
|
17
|
-
## Run me
|
|
18
|
-
|
|
19
|
-
🔴 FIRST, before any other step:
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs argument-arc <paper-dir>
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
26
|
-
state — so starting is an event, and events get written down.
|
|
27
|
-
|
|
28
17
|
The failure it exists to catch has a signature: every paragraph is defensible, every number is real,
|
|
29
18
|
and the reader still finishes the section unable to say what it was for. That is not a prose problem
|
|
30
19
|
and no amount of rewriting sentences fixes it.
|
|
@@ -48,7 +37,6 @@ came out — which is how a run gets thrown away. That is not hypothetical: it w
|
|
|
48
37
|
data is collected costs the data. Costs a paragraph; saves a study.**
|
|
49
38
|
|
|
50
39
|
`build-benchmark` reads this paragraph before designing, and refuses to proceed if `frame` is empty.
|
|
51
|
-
`pipeline-check.mjs` reports a study that ran with no stated claim.
|
|
52
40
|
|
|
53
41
|
*Added 2026-08-03 alongside the replacement of the numbered stage list — this skill previously existed
|
|
54
42
|
only as a repair, which meant nobody stated the claim while stating it was still cheap.*
|
|
@@ -125,28 +113,6 @@ most needs help. This skill does:
|
|
|
125
113
|
the calendar against it is a category error.
|
|
126
114
|
- **Rebuild produces a new outline through steps 1–4 above, and it too gets shown before editing.**
|
|
127
115
|
|
|
128
|
-
## Record the verdict
|
|
129
|
-
|
|
130
|
-
🔴 LAST step, once the deliverable exists:
|
|
131
|
-
|
|
132
|
-
```
|
|
133
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> FINDING <count> <report-path>
|
|
134
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> ABSTAINED <reason> "<one line>"
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
🔴 **There is no PASS.** "The arc carries the reader" is not a value this pass can write down; it is
|
|
138
|
-
what a reader may conclude from the absence of findings, and the concluding is theirs.
|
|
139
|
-
|
|
140
|
-
**FINDING** — the arc is broken; `<count>` is the number of sections the new outline moves, merges
|
|
141
|
-
or deletes, and `<report-path>` is that outline. Add `--blocking` when there is no conclusion
|
|
142
|
-
sentence to build an arc from: that refusal is a finding about the draft, not an aborted run, and
|
|
143
|
-
`<report-path>` is the one-line statement of what is missing.
|
|
144
|
-
**ABSTAINED** — `no-witness`: the outline was read end to end and nothing moved. `blocked`: there
|
|
145
|
-
was no outline to read at all.
|
|
146
|
-
|
|
147
|
-
An `ABSTAINED no-witness` on a draft the author has twice called a pile is a missed finding, and
|
|
148
|
-
`status.mjs` will start asking about a check that has only ever abstained.
|
|
149
|
-
|
|
150
116
|
## Rules
|
|
151
117
|
|
|
152
118
|
- **The arc is judged on the outline, never on the draft.** If you find yourself rereading paragraphs
|
|
@@ -10,15 +10,7 @@ export default experimental_skill({
|
|
|
10
10
|
name: "argument-arc",
|
|
11
11
|
description:
|
|
12
12
|
"Build or repair the paper's argument architecture — the one-sentence-per-section outline, the bottom-up inevitability pass, and the name/number budget. Run it when the reader says the paper throws ideas at them, when a structural objection repeats, or before any large rewrite. Not a prose or length skill.",
|
|
13
|
-
tools: [
|
|
14
|
-
"Read",
|
|
15
|
-
"Write",
|
|
16
|
-
"Grep",
|
|
17
|
-
"Glob",
|
|
18
|
-
"Agent",
|
|
19
|
-
"Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*)",
|
|
20
|
-
"Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)",
|
|
21
|
-
],
|
|
13
|
+
tools: ["Read", "Write", "Grep", "Glob", "Agent"],
|
|
22
14
|
body: `
|
|
23
15
|
# argument-arc — does the paper carry the reader to one conclusion
|
|
24
16
|
|
|
@@ -28,17 +20,6 @@ export default experimental_skill({
|
|
|
28
20
|
> whether the argument exists. Run it *before* them — cutting words inside a broken arc is how a
|
|
29
21
|
> session burns a day and ships the same paper.
|
|
30
22
|
|
|
31
|
-
## Run me
|
|
32
|
-
|
|
33
|
-
🔴 FIRST, before any other step:
|
|
34
|
-
|
|
35
|
-
\`\`\`
|
|
36
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs argument-arc <paper-dir>
|
|
37
|
-
\`\`\`
|
|
38
|
-
|
|
39
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
40
|
-
state — so starting is an event, and events get written down.
|
|
41
|
-
|
|
42
23
|
The failure it exists to catch has a signature: every paragraph is defensible, every number is real,
|
|
43
24
|
and the reader still finishes the section unable to say what it was for. That is not a prose problem
|
|
44
25
|
and no amount of rewriting sentences fixes it.
|
|
@@ -62,7 +43,6 @@ came out — which is how a run gets thrown away. That is not hypothetical: it w
|
|
|
62
43
|
data is collected costs the data. Costs a paragraph; saves a study.**
|
|
63
44
|
|
|
64
45
|
\`build-benchmark\` reads this paragraph before designing, and refuses to proceed if \`frame\` is empty.
|
|
65
|
-
\`pipeline-check.mjs\` reports a study that ran with no stated claim.
|
|
66
46
|
|
|
67
47
|
*Added 2026-08-03 alongside the replacement of the numbered stage list — this skill previously existed
|
|
68
48
|
only as a repair, which meant nobody stated the claim while stating it was still cheap.*
|
|
@@ -139,28 +119,6 @@ most needs help. This skill does:
|
|
|
139
119
|
the calendar against it is a category error.
|
|
140
120
|
- **Rebuild produces a new outline through steps 1–4 above, and it too gets shown before editing.**
|
|
141
121
|
|
|
142
|
-
## Record the verdict
|
|
143
|
-
|
|
144
|
-
🔴 LAST step, once the deliverable exists:
|
|
145
|
-
|
|
146
|
-
\`\`\`
|
|
147
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> FINDING <count> <report-path>
|
|
148
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> ABSTAINED <reason> "<one line>"
|
|
149
|
-
\`\`\`
|
|
150
|
-
|
|
151
|
-
🔴 **There is no PASS.** "The arc carries the reader" is not a value this pass can write down; it is
|
|
152
|
-
what a reader may conclude from the absence of findings, and the concluding is theirs.
|
|
153
|
-
|
|
154
|
-
**FINDING** — the arc is broken; \`<count>\` is the number of sections the new outline moves, merges
|
|
155
|
-
or deletes, and \`<report-path>\` is that outline. Add \`--blocking\` when there is no conclusion
|
|
156
|
-
sentence to build an arc from: that refusal is a finding about the draft, not an aborted run, and
|
|
157
|
-
\`<report-path>\` is the one-line statement of what is missing.
|
|
158
|
-
**ABSTAINED** — \`no-witness\`: the outline was read end to end and nothing moved. \`blocked\`: there
|
|
159
|
-
was no outline to read at all.
|
|
160
|
-
|
|
161
|
-
An \`ABSTAINED no-witness\` on a draft the author has twice called a pile is a missed finding, and
|
|
162
|
-
\`status.mjs\` will start asking about a check that has only ever abstained.
|
|
163
|
-
|
|
164
122
|
## Rules
|
|
165
123
|
|
|
166
124
|
- **The arc is judged on the outline, never on the draft.** If you find yourself rereading paragraphs
|
|
@@ -5,21 +5,10 @@ context: fork
|
|
|
5
5
|
allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, Agent]
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
<!-- vigiles:sha256:
|
|
8
|
+
<!-- vigiles:sha256:0b91129ca6a6b2a3 compiled from skills/build-benchmark/SKILL.md.spec.ts -->
|
|
9
9
|
|
|
10
10
|
# build-benchmark — the study + the artifact reviewers can run
|
|
11
11
|
|
|
12
|
-
## Run me
|
|
13
|
-
|
|
14
|
-
🔴 FIRST, before any other step:
|
|
15
|
-
|
|
16
|
-
```
|
|
17
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs build-benchmark <paper-dir>
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
21
|
-
state — so starting is an event, and events get written down.
|
|
22
|
-
|
|
23
12
|
A measurement paper is only as strong as the artifact a reviewer can `cd` into and re-run. This skill
|
|
24
13
|
covers both halves: the study design that makes the finding true, and the self-checking artifact that
|
|
25
14
|
makes it *verifiable*. The contribution is the **method**, not the one tool you happened to test — build
|
|
@@ -163,35 +152,6 @@ real-code-through-real-contract execution reveals it.
|
|
|
163
152
|
Before submitting, verify the artifact you built with the reviewer-side reproduction protocol:
|
|
164
153
|
**`references/adversarial-cold-repro.md`** (cold re-run, three-way reconcile, robustness attacks).
|
|
165
154
|
|
|
166
|
-
## Record the verdict
|
|
167
|
-
|
|
168
|
-
🔴 LAST step, once the deliverable exists:
|
|
169
|
-
|
|
170
|
-
```
|
|
171
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> FINDING <count> <report-path>
|
|
172
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> ABSTAINED <reason> "<one line>"
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
🔴 **There is no PASS.** An artifact that recomputes every headline number and exits 0 has produced
|
|
176
|
-
no finding; it has not certified the study. Record the absence, do not name it a success.
|
|
177
|
-
|
|
178
|
-
**FINDING** — `<count>` numbers did not reproduce, or reproduce only with caveats; `<report-path>`
|
|
179
|
-
is the artifact output. Add `--blocking` for the §0 refusal: `frame` is empty, so the study was not
|
|
180
|
-
designed.
|
|
181
|
-
**ABSTAINED** — `no-witness`: the artifact ran and every number reproduced. `input-missing`: the
|
|
182
|
-
raw data is not in the repo. `crashed`: the harness itself died.
|
|
183
|
-
|
|
184
|
-
🔴 That §0 refusal is a **finding, not an aborted run** — it is a fact about the work, so it is a
|
|
185
|
-
FINDING and not an abstention. Record it and stop. A study that was never designed leaves exactly
|
|
186
|
-
the same silence as one that is still running, and the difference costs a week to rediscover.
|
|
187
|
-
|
|
188
|
-
🔴 **THREE MECHANICAL CHECKS FILE UNDER THIS SKILL** and each has its own ledger row:
|
|
189
|
-
`build-benchmark/check-provenance`, `build-benchmark/arm-permutation`,
|
|
190
|
-
`build-benchmark/delivered-pdf` (see `.claude/skills/paper-pipeline/scripts/run-mechanical.mjs`). Until 2026-08-10 the
|
|
191
|
-
ledger keyed on the SKILL, so a clean run of one erased a finding of another from every derived
|
|
192
|
-
view — which is why two of the three sat unwired. This block records the JUDGEMENT pass, under the
|
|
193
|
-
bare key `build-benchmark`; never file a mechanical result here.
|
|
194
|
-
|
|
195
155
|
## Compose with
|
|
196
156
|
- **argument-arc (frame mode)** — 🔴 **hard input.** Owns row `frame`, the stated claim. No `frame`, no study.
|
|
197
157
|
- **research-ideate** (upstream) — supplies the contribution and the pitfall to invert; this skill turns
|
|
@@ -15,17 +15,6 @@ export default experimental_skill({
|
|
|
15
15
|
body: `
|
|
16
16
|
# build-benchmark — the study + the artifact reviewers can run
|
|
17
17
|
|
|
18
|
-
## Run me
|
|
19
|
-
|
|
20
|
-
🔴 FIRST, before any other step:
|
|
21
|
-
|
|
22
|
-
\`\`\`
|
|
23
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs build-benchmark <paper-dir>
|
|
24
|
-
\`\`\`
|
|
25
|
-
|
|
26
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
27
|
-
state — so starting is an event, and events get written down.
|
|
28
|
-
|
|
29
18
|
A measurement paper is only as strong as the artifact a reviewer can \`cd\` into and re-run. This skill
|
|
30
19
|
covers both halves: the study design that makes the finding true, and the self-checking artifact that
|
|
31
20
|
makes it *verifiable*. The contribution is the **method**, not the one tool you happened to test — build
|
|
@@ -169,35 +158,6 @@ real-code-through-real-contract execution reveals it.
|
|
|
169
158
|
Before submitting, verify the artifact you built with the reviewer-side reproduction protocol:
|
|
170
159
|
**\`references/adversarial-cold-repro.md\`** (cold re-run, three-way reconcile, robustness attacks).
|
|
171
160
|
|
|
172
|
-
## Record the verdict
|
|
173
|
-
|
|
174
|
-
🔴 LAST step, once the deliverable exists:
|
|
175
|
-
|
|
176
|
-
\`\`\`
|
|
177
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> FINDING <count> <report-path>
|
|
178
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> ABSTAINED <reason> "<one line>"
|
|
179
|
-
\`\`\`
|
|
180
|
-
|
|
181
|
-
🔴 **There is no PASS.** An artifact that recomputes every headline number and exits 0 has produced
|
|
182
|
-
no finding; it has not certified the study. Record the absence, do not name it a success.
|
|
183
|
-
|
|
184
|
-
**FINDING** — \`<count>\` numbers did not reproduce, or reproduce only with caveats; \`<report-path>\`
|
|
185
|
-
is the artifact output. Add \`--blocking\` for the §0 refusal: \`frame\` is empty, so the study was not
|
|
186
|
-
designed.
|
|
187
|
-
**ABSTAINED** — \`no-witness\`: the artifact ran and every number reproduced. \`input-missing\`: the
|
|
188
|
-
raw data is not in the repo. \`crashed\`: the harness itself died.
|
|
189
|
-
|
|
190
|
-
🔴 That §0 refusal is a **finding, not an aborted run** — it is a fact about the work, so it is a
|
|
191
|
-
FINDING and not an abstention. Record it and stop. A study that was never designed leaves exactly
|
|
192
|
-
the same silence as one that is still running, and the difference costs a week to rediscover.
|
|
193
|
-
|
|
194
|
-
🔴 **THREE MECHANICAL CHECKS FILE UNDER THIS SKILL** and each has its own ledger row:
|
|
195
|
-
\`build-benchmark/check-provenance\`, \`build-benchmark/arm-permutation\`,
|
|
196
|
-
\`build-benchmark/delivered-pdf\` (see \`.claude/skills/paper-pipeline/scripts/run-mechanical.mjs\`). Until 2026-08-10 the
|
|
197
|
-
ledger keyed on the SKILL, so a clean run of one erased a finding of another from every derived
|
|
198
|
-
view — which is why two of the three sat unwired. This block records the JUDGEMENT pass, under the
|
|
199
|
-
bare key \`build-benchmark\`; never file a mechanical result here.
|
|
200
|
-
|
|
201
161
|
## Compose with
|
|
202
162
|
- **argument-arc (frame mode)** — 🔴 **hard input.** Owns row \`frame\`, the stated claim. No \`frame\`, no study.
|
|
203
163
|
- **research-ideate** (upstream) — supplies the contribution and the pitfall to invert; this skill turns
|
|
@@ -4,21 +4,10 @@ description: On acceptance, turn the anonymized-for-review paper into the de-ano
|
|
|
4
4
|
allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
<!-- vigiles:sha256:
|
|
7
|
+
<!-- vigiles:sha256:5c85ef4004c31956 compiled from skills/camera-ready/SKILL.md.spec.ts -->
|
|
8
8
|
|
|
9
9
|
# camera-ready — de-anonymize an accepted paper into the final proceedings version
|
|
10
10
|
|
|
11
|
-
## Run me
|
|
12
|
-
|
|
13
|
-
🔴 FIRST, before any other step:
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs camera-ready <paper-dir>
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
20
|
-
state — so starting is an event, and events get written down.
|
|
21
|
-
|
|
22
11
|
The reviewed PDF was anonymized on purpose. Acceptance flips that: the camera-ready carries your
|
|
23
12
|
real name, your real repo, and an archival DOI — and it's the version that gets indexed, so it's the
|
|
24
13
|
actual authorship evidence. This skill is the reverse of the anonymization you did at
|
|
@@ -113,28 +102,6 @@ If tight, ACM allows references to spill into the reference-only extra pages.
|
|
|
113
102
|
- Record the paper's DOI, the artifact DOI, and the ORCID in the paper's HANDOFF — those three IDs are
|
|
114
103
|
the authorship evidence and the anchor the extension (`extend-paper`) builds on.
|
|
115
104
|
|
|
116
|
-
## 6. Record the verdict
|
|
117
|
-
|
|
118
|
-
🔴 LAST step, once the deliverable exists:
|
|
119
|
-
|
|
120
|
-
```
|
|
121
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> FINDING <count> <report-path>
|
|
122
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> ABSTAINED <reason> "<one line>"
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
**FINDING** — `<count>` residual items still open; `<report-path>` names them. Add `--blocking` for
|
|
126
|
-
anything that must not be pushed past: anonymization residue, a dead artifact link, or — on a
|
|
127
|
-
security paper — disclosure not yet complete.
|
|
128
|
-
**ABSTAINED** — `no-witness`: shipped, de-anonymized, DOI live, page limit re-checked, with the DOI
|
|
129
|
-
in the note. `blocked`: the acceptance notice has not arrived, so there is nothing to make ready.
|
|
130
|
-
|
|
131
|
-
🔴 That blocking finding is the only one in this pipeline whose consequence is **irreversible**. The
|
|
132
|
-
public de-anonymized repo is Google-findable the moment it is pushed, so record it before, not after.
|
|
133
|
-
|
|
134
|
-
🔴 **There is no PASS**, and on this skill that is not a formality: a stored "shipped" would have
|
|
135
|
-
been the one row in the pipeline that could be true of a repo nobody had looked at. The DOI in the
|
|
136
|
-
note is the witness. Without it there is nothing to check the row against.
|
|
137
|
-
|
|
138
105
|
## Compose with
|
|
139
106
|
- **submit-paper** (upstream — this reverses what it anonymized).
|
|
140
107
|
- **paper-pipeline/references/anonymization.md** — the canonical list of anonymization moves; undo each.
|
|
@@ -23,17 +23,6 @@ export default experimental_skill({
|
|
|
23
23
|
body: `
|
|
24
24
|
# camera-ready — de-anonymize an accepted paper into the final proceedings version
|
|
25
25
|
|
|
26
|
-
## Run me
|
|
27
|
-
|
|
28
|
-
🔴 FIRST, before any other step:
|
|
29
|
-
|
|
30
|
-
\`\`\`
|
|
31
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs camera-ready <paper-dir>
|
|
32
|
-
\`\`\`
|
|
33
|
-
|
|
34
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
35
|
-
state — so starting is an event, and events get written down.
|
|
36
|
-
|
|
37
26
|
The reviewed PDF was anonymized on purpose. Acceptance flips that: the camera-ready carries your
|
|
38
27
|
real name, your real repo, and an archival DOI — and it's the version that gets indexed, so it's the
|
|
39
28
|
actual authorship evidence. This skill is the reverse of the anonymization you did at
|
|
@@ -128,28 +117,6 @@ If tight, ACM allows references to spill into the reference-only extra pages.
|
|
|
128
117
|
- Record the paper's DOI, the artifact DOI, and the ORCID in the paper's HANDOFF — those three IDs are
|
|
129
118
|
the authorship evidence and the anchor the extension (\`extend-paper\`) builds on.
|
|
130
119
|
|
|
131
|
-
## 6. Record the verdict
|
|
132
|
-
|
|
133
|
-
🔴 LAST step, once the deliverable exists:
|
|
134
|
-
|
|
135
|
-
\`\`\`
|
|
136
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> FINDING <count> <report-path>
|
|
137
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> ABSTAINED <reason> "<one line>"
|
|
138
|
-
\`\`\`
|
|
139
|
-
|
|
140
|
-
**FINDING** — \`<count>\` residual items still open; \`<report-path>\` names them. Add \`--blocking\` for
|
|
141
|
-
anything that must not be pushed past: anonymization residue, a dead artifact link, or — on a
|
|
142
|
-
security paper — disclosure not yet complete.
|
|
143
|
-
**ABSTAINED** — \`no-witness\`: shipped, de-anonymized, DOI live, page limit re-checked, with the DOI
|
|
144
|
-
in the note. \`blocked\`: the acceptance notice has not arrived, so there is nothing to make ready.
|
|
145
|
-
|
|
146
|
-
🔴 That blocking finding is the only one in this pipeline whose consequence is **irreversible**. The
|
|
147
|
-
public de-anonymized repo is Google-findable the moment it is pushed, so record it before, not after.
|
|
148
|
-
|
|
149
|
-
🔴 **There is no PASS**, and on this skill that is not a formality: a stored "shipped" would have
|
|
150
|
-
been the one row in the pipeline that could be true of a repo nobody had looked at. The DOI in the
|
|
151
|
-
note is the witness. Without it there is nothing to check the row against.
|
|
152
|
-
|
|
153
120
|
## Compose with
|
|
154
121
|
- **submit-paper** (upstream — this reverses what it anonymized).
|
|
155
122
|
- **paper-pipeline/references/anonymization.md** — the canonical list of anonymization moves; undo each.
|
|
@@ -5,20 +5,11 @@ context: fork
|
|
|
5
5
|
allowed-tools: [Bash, Read, Agent]
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
<!-- vigiles:sha256:
|
|
8
|
+
<!-- vigiles:sha256:e45391841e689aa9 compiled from skills/cold-read-diff/SKILL.md.spec.ts -->
|
|
9
9
|
|
|
10
10
|
# cold-read-diff — the reader who cannot fake understanding
|
|
11
11
|
|
|
12
|
-
## Run me
|
|
13
12
|
|
|
14
|
-
🔴 FIRST, before any other step:
|
|
15
|
-
|
|
16
|
-
```
|
|
17
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs cold-read-diff <paper-dir>
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
21
|
-
state — so starting is an event, and events get written down.
|
|
22
13
|
|
|
23
14
|
## The failure this exists for
|
|
24
15
|
|
|
@@ -120,25 +111,6 @@ findings:
|
|
|
120
111
|
---
|
|
121
112
|
```
|
|
122
113
|
|
|
123
|
-
## Record the verdict
|
|
124
|
-
|
|
125
|
-
🔴 LAST step, once the deliverable exists:
|
|
126
|
-
|
|
127
|
-
```
|
|
128
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> FINDING <count> <report-path>
|
|
129
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> ABSTAINED <reason> "<one line>"
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
**FINDING** — `<count>` is the number of changed sentences the cold reader could not restate (every
|
|
133
|
-
`CANNOT PARSE` counts), `<report-path>` is the `reviews/*cold-read*.md` file.
|
|
134
|
-
**ABSTAINED** — `no-witness`: every changed sentence came back restated correctly.
|
|
135
|
-
`input-missing`: the diff held no prose to read.
|
|
136
|
-
|
|
137
|
-
🔴 These two are different answers and the difference is the whole reason the vocabulary is closed:
|
|
138
|
-
one says a reader read it and found nothing, the other says there was nothing to hand a reader.
|
|
139
|
-
Prose collapses them and the old `PASS`/`ABSENT` pair only half-separated them, because `PASS` also
|
|
140
|
-
got recorded when nobody had run a reader at all. There is no `PASS` now; the reason is the answer.
|
|
141
|
-
|
|
142
114
|
## Rules
|
|
143
115
|
|
|
144
116
|
- 🔴 **No context in the prompt. Ever.** Not the title, not the abstract, not "this is a paper about
|
|
@@ -158,12 +130,6 @@ got recorded when nobody had run a reader at all. There is no `PASS` now; the re
|
|
|
158
130
|
- **Run it on your own fixes too.** The author is the least qualified judge of whether his repair
|
|
159
131
|
reads, and that is exactly when he feels most certain.
|
|
160
132
|
|
|
161
|
-
## Enforcement
|
|
162
|
-
|
|
163
|
-
`pipeline-check.mjs` raises `stale-cold-read` when the newest `reviews/*cold-read*.md` is older than
|
|
164
|
-
the paper source, and `no-cold-read` when none exists. The date comparison is the whole mechanism:
|
|
165
|
-
a cold read that predates the current text describes prose that no longer exists.
|
|
166
|
-
|
|
167
133
|
## Compose with
|
|
168
134
|
|
|
169
135
|
- `grade-paper-writing` — the batch readability gate; this is its continuous counterpart. That one
|
|
@@ -14,16 +14,7 @@ export default experimental_skill({
|
|
|
14
14
|
body: `
|
|
15
15
|
# cold-read-diff — the reader who cannot fake understanding
|
|
16
16
|
|
|
17
|
-
## Run me
|
|
18
17
|
|
|
19
|
-
🔴 FIRST, before any other step:
|
|
20
|
-
|
|
21
|
-
\`\`\`
|
|
22
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs cold-read-diff <paper-dir>
|
|
23
|
-
\`\`\`
|
|
24
|
-
|
|
25
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
26
|
-
state — so starting is an event, and events get written down.
|
|
27
18
|
|
|
28
19
|
## The failure this exists for
|
|
29
20
|
|
|
@@ -125,25 +116,6 @@ findings:
|
|
|
125
116
|
---
|
|
126
117
|
\`\`\`
|
|
127
118
|
|
|
128
|
-
## Record the verdict
|
|
129
|
-
|
|
130
|
-
🔴 LAST step, once the deliverable exists:
|
|
131
|
-
|
|
132
|
-
\`\`\`
|
|
133
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> FINDING <count> <report-path>
|
|
134
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> ABSTAINED <reason> "<one line>"
|
|
135
|
-
\`\`\`
|
|
136
|
-
|
|
137
|
-
**FINDING** — \`<count>\` is the number of changed sentences the cold reader could not restate (every
|
|
138
|
-
\`CANNOT PARSE\` counts), \`<report-path>\` is the \`reviews/*cold-read*.md\` file.
|
|
139
|
-
**ABSTAINED** — \`no-witness\`: every changed sentence came back restated correctly.
|
|
140
|
-
\`input-missing\`: the diff held no prose to read.
|
|
141
|
-
|
|
142
|
-
🔴 These two are different answers and the difference is the whole reason the vocabulary is closed:
|
|
143
|
-
one says a reader read it and found nothing, the other says there was nothing to hand a reader.
|
|
144
|
-
Prose collapses them and the old \`PASS\`/\`ABSENT\` pair only half-separated them, because \`PASS\` also
|
|
145
|
-
got recorded when nobody had run a reader at all. There is no \`PASS\` now; the reason is the answer.
|
|
146
|
-
|
|
147
119
|
## Rules
|
|
148
120
|
|
|
149
121
|
- 🔴 **No context in the prompt. Ever.** Not the title, not the abstract, not "this is a paper about
|
|
@@ -163,12 +135,6 @@ got recorded when nobody had run a reader at all. There is no \`PASS\` now; the
|
|
|
163
135
|
- **Run it on your own fixes too.** The author is the least qualified judge of whether his repair
|
|
164
136
|
reads, and that is exactly when he feels most certain.
|
|
165
137
|
|
|
166
|
-
## Enforcement
|
|
167
|
-
|
|
168
|
-
\`pipeline-check.mjs\` raises \`stale-cold-read\` when the newest \`reviews/*cold-read*.md\` is older than
|
|
169
|
-
the paper source, and \`no-cold-read\` when none exists. The date comparison is the whole mechanism:
|
|
170
|
-
a cold read that predates the current text describes prose that no longer exists.
|
|
171
|
-
|
|
172
138
|
## Compose with
|
|
173
139
|
|
|
174
140
|
- \`grade-paper-writing\` — the batch readability gate; this is its continuous counterpart. That one
|
|
@@ -1,24 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: draft-paper
|
|
3
3
|
description: Use when the numbers exist and it's time to WRITE the paper — "draft the paper", "turn these findings into a submission", "write the abstract/intro/threats". Gives the section skeleton of a measurement/benchmark paper plus what gets it accepted AND cited — precise claim-sizing (including an explicit "what we do NOT claim"), a construct-validity frame, an honest threats-to-validity section that turns limitations in your favor, and one memorable stat that travels. Encodes the two theses that carried real measurement papers ("measuring the wrong number", "safety theater"). NOT for grading finished prose (grade-paper-writing) or structural editing (tighten-paper) — this is the generative counterpart. Compose with build-benchmark (numbers), grade-paper-writing (prose QA), render-paper, verify-citations, then the review skills.
|
|
4
|
-
allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, Skill
|
|
4
|
+
allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, Skill]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
<!-- vigiles:sha256:
|
|
7
|
+
<!-- vigiles:sha256:46bb85bfaa45e595 compiled from skills/draft-paper/SKILL.md.spec.ts -->
|
|
8
8
|
|
|
9
9
|
# draft-paper — prose that survives review and gets cited
|
|
10
10
|
|
|
11
|
-
## Run me
|
|
12
|
-
|
|
13
|
-
🔴 FIRST, before any other step:
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs draft-paper <paper-dir>
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
20
|
-
state — so starting is an event, and events get written down.
|
|
21
|
-
|
|
22
11
|
A measurement paper lives or dies on two things reviewers actually reward: a **reusable method/norm**
|
|
23
12
|
they can apply to the next system, and **claim-sizing so precise it can't be attacked**. Numbers alone
|
|
24
13
|
are a blog post. This skill turns `build-benchmark`'s output into that kind of draft.
|
|
@@ -101,34 +90,6 @@ For papers they duplicate — and are superseded by — `grade-paper-writing` +
|
|
|
101
90
|
pass (the blog skills lack the persona fix, so they under-fire on paper prose). Never route paper
|
|
102
91
|
prose QA to them.
|
|
103
92
|
|
|
104
|
-
## Record the verdict
|
|
105
|
-
|
|
106
|
-
🔴 LAST step, once the deliverable exists:
|
|
107
|
-
|
|
108
|
-
```
|
|
109
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> FINDING <count> <report-path>
|
|
110
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> ABSTAINED <reason> "<one line>"
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
This skill generates rather than judges, so what it records is about the run, not about the paper.
|
|
114
|
-
|
|
115
|
-
**FINDING** — it declined to draft because a required input was missing: no numbers from
|
|
116
|
-
`build-benchmark`, or an empty `frame` paragraph from `argument-arc`. `--blocking`, always, because
|
|
117
|
-
drafting past it produces prose about numbers that do not exist.
|
|
118
|
-
**ABSTAINED** — `no-witness`: sections were written and the generator has nothing to report about
|
|
119
|
-
the paper. Put the drafted sections in the note; they are the deliverable, not evidence of a defect.
|
|
120
|
-
|
|
121
|
-
🔴 **Design smell, stated plainly: this gate will almost always record an abstention**, and
|
|
122
|
-
`status.mjs` will flag it as one that has never returned a finding. Leave the flag standing — it is
|
|
123
|
-
telling the truth. A generator is not a gate, and the only honest negative it can produce is the
|
|
124
|
-
refusal above. If a run ever ends with prose written from numbers that do not exist, that is a
|
|
125
|
-
`FINDING --blocking` and must be recorded as one rather than quietly upgraded.
|
|
126
|
-
|
|
127
|
-
🔴 Deleting `PASS` did not fix this skill and was never going to: the old vocabulary let it write
|
|
128
|
-
down "I produced sections" as though that were an answer about the manuscript, and the new one
|
|
129
|
-
simply refuses to. The generator is still not a gate. `draft-paper/population-map` — a real check —
|
|
130
|
-
is the row that can say no about this skill's output.
|
|
131
|
-
|
|
132
93
|
## Compose with
|
|
133
94
|
- **`build-benchmark`** — its numbers/CIs are the Results section's raw material; never hand-type a
|
|
134
95
|
number that isn't in its output (that's how paper↔artifact mismatches get born).
|
|
@@ -10,31 +10,10 @@ export default experimental_skill({
|
|
|
10
10
|
name: "draft-paper",
|
|
11
11
|
description:
|
|
12
12
|
'Use when the numbers exist and it\'s time to WRITE the paper — "draft the paper", "turn these findings into a submission", "write the abstract/intro/threats". Gives the section skeleton of a measurement/benchmark paper plus what gets it accepted AND cited — precise claim-sizing (including an explicit "what we do NOT claim"), a construct-validity frame, an honest threats-to-validity section that turns limitations in your favor, and one memorable stat that travels. Encodes the two theses that carried real measurement papers ("measuring the wrong number", "safety theater"). NOT for grading finished prose (grade-paper-writing) or structural editing (tighten-paper) — this is the generative counterpart. Compose with build-benchmark (numbers), grade-paper-writing (prose QA), render-paper, verify-citations, then the review skills.',
|
|
13
|
-
tools: [
|
|
14
|
-
"Read",
|
|
15
|
-
"Write",
|
|
16
|
-
"Edit",
|
|
17
|
-
"Grep",
|
|
18
|
-
"Glob",
|
|
19
|
-
"Agent",
|
|
20
|
-
"Skill",
|
|
21
|
-
"Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*)",
|
|
22
|
-
"Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)",
|
|
23
|
-
],
|
|
13
|
+
tools: ["Read", "Write", "Edit", "Grep", "Glob", "Agent", "Skill"],
|
|
24
14
|
body: `
|
|
25
15
|
# draft-paper — prose that survives review and gets cited
|
|
26
16
|
|
|
27
|
-
## Run me
|
|
28
|
-
|
|
29
|
-
🔴 FIRST, before any other step:
|
|
30
|
-
|
|
31
|
-
\`\`\`
|
|
32
|
-
node .claude/skills/paper-pipeline/scripts/announce.mjs draft-paper <paper-dir>
|
|
33
|
-
\`\`\`
|
|
34
|
-
|
|
35
|
-
An advisory pass cannot be observed failing — silence is both its error state and its normal
|
|
36
|
-
state — so starting is an event, and events get written down.
|
|
37
|
-
|
|
38
17
|
A measurement paper lives or dies on two things reviewers actually reward: a **reusable method/norm**
|
|
39
18
|
they can apply to the next system, and **claim-sizing so precise it can't be attacked**. Numbers alone
|
|
40
19
|
are a blog post. This skill turns \`build-benchmark\`'s output into that kind of draft.
|
|
@@ -117,34 +96,6 @@ For papers they duplicate — and are superseded by — \`grade-paper-writing\`
|
|
|
117
96
|
pass (the blog skills lack the persona fix, so they under-fire on paper prose). Never route paper
|
|
118
97
|
prose QA to them.
|
|
119
98
|
|
|
120
|
-
## Record the verdict
|
|
121
|
-
|
|
122
|
-
🔴 LAST step, once the deliverable exists:
|
|
123
|
-
|
|
124
|
-
\`\`\`
|
|
125
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> FINDING <count> <report-path>
|
|
126
|
-
node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> ABSTAINED <reason> "<one line>"
|
|
127
|
-
\`\`\`
|
|
128
|
-
|
|
129
|
-
This skill generates rather than judges, so what it records is about the run, not about the paper.
|
|
130
|
-
|
|
131
|
-
**FINDING** — it declined to draft because a required input was missing: no numbers from
|
|
132
|
-
\`build-benchmark\`, or an empty \`frame\` paragraph from \`argument-arc\`. \`--blocking\`, always, because
|
|
133
|
-
drafting past it produces prose about numbers that do not exist.
|
|
134
|
-
**ABSTAINED** — \`no-witness\`: sections were written and the generator has nothing to report about
|
|
135
|
-
the paper. Put the drafted sections in the note; they are the deliverable, not evidence of a defect.
|
|
136
|
-
|
|
137
|
-
🔴 **Design smell, stated plainly: this gate will almost always record an abstention**, and
|
|
138
|
-
\`status.mjs\` will flag it as one that has never returned a finding. Leave the flag standing — it is
|
|
139
|
-
telling the truth. A generator is not a gate, and the only honest negative it can produce is the
|
|
140
|
-
refusal above. If a run ever ends with prose written from numbers that do not exist, that is a
|
|
141
|
-
\`FINDING --blocking\` and must be recorded as one rather than quietly upgraded.
|
|
142
|
-
|
|
143
|
-
🔴 Deleting \`PASS\` did not fix this skill and was never going to: the old vocabulary let it write
|
|
144
|
-
down "I produced sections" as though that were an answer about the manuscript, and the new one
|
|
145
|
-
simply refuses to. The generator is still not a gate. \`draft-paper/population-map\` — a real check —
|
|
146
|
-
is the row that can say no about this skill's output.
|
|
147
|
-
|
|
148
99
|
## Compose with
|
|
149
100
|
- **\`build-benchmark\`** — its numbers/CIs are the Results section's raw material; never hand-type a
|
|
150
101
|
number that isn't in its output (that's how paper↔artifact mismatches get born).
|