Skip to content

Tighten the handout editor and finalizer skills - #386

Merged
PatrikBak merged 1 commit into
mainfrom
patrik/handout-skill-audit-fixes
Aug 22, 2026
Merged

Tighten the handout editor and finalizer skills#386
PatrikBak merged 1 commit into
mainfrom
patrik/handout-skill-audit-fixes

Conversation

@PatrikBak

Copy link
Copy Markdown
Owner

Two rules the handouts already follow but neither skill stated:

  • An \eqno earns its number only when the text points back at it from further than the paragraph directly below. A display cited once in the next sentence stays untagged, and a block's surviving numbers run from (1).
  • hideSolutionsAndProofs gates the UI only. The CLI never reads handouts.json, so the full-solutions PDF is still built, uploaded and fetchable at its R2 URL — worth saying out loud when the flag is being used to keep solutions from a class.

The rest is an audit pass against the current skill-authoring docs:

  • The \EnvId naming rule was stated whole in both skills. handout-editor now owns it, including the two halves only the finalizer carried (a name is unique within its file, and the competition source spoils a problem the same way the technique does), and handout-finalize points at it instead of restating it.
  • The dash rule no longer says "his prose" / "he asked for it here", which a fresh reader has to decode before it can act.
  • handout-editor drops an opening persona line that its own description already carries into the system prompt.

🤖 Generated with Claude Code

Two rules the handouts already follow but neither skill stated. An \eqno
earns its number only when the text points back at it from further than the
paragraph below, so a display cited once in the next sentence stays untagged.
And hideSolutionsAndProofs gates the UI only: the CLI never reads
handouts.json, so the full PDF is still built, uploaded and fetchable on R2,
which matters when the flag is meant to keep solutions from a class.

The rest is an audit pass. The \EnvId naming rule was stated whole in both
skills, so handout-editor now owns it (plus the two halves only the finalizer
carried: names are unique within a file, and the competition source spoils a
problem the same way the technique does) and the finalizer points at it. The
dash rule no longer says "his prose" and "he asked for it here", which a fresh
reader has to decode, and the editor drops an opening persona line its own
description already carries.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
math-comps Ready Ready Preview Aug 22, 2026 4:34pm

@PatrikBak
PatrikBak enabled auto-merge August 22, 2026 16:32
@PatrikBak
PatrikBak merged commit 0a53ea0 into main Aug 22, 2026
5 checks passed
@PatrikBak
PatrikBak deleted the patrik/handout-skill-audit-fixes branch August 22, 2026 16:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant