Skip to content

Prepare the skill for strangers: render step, bundled font, leaner download - #11

Merged
pasqualevitiello merged 4 commits into
mainfrom
skill-launch-fixes
Nov 14, 2026
Merged

pasqualevitiello merged 4 commits into
mainfrom
skill-launch-fixes

Conversation

@pasqualevitiello

@pasqualevitiello pasqualevitiello commented Nov 14, 2026 •

Copy link
Copy Markdown
Owner

Summary

Twelve briefs were run in fresh Claude Code and Codex sessions that saw only the published archive. This adds what those runs showed to be missing and removes what none of them opened.

 skills/plotter/
 ├── SKILL.md                      # maintainer rules moved to AGENTS.md
 ├── NOTICE.md                     # shortened; both licenses stay
 ├── assets/
+│   └── fonts/                    # Cal Sans + OFL.txt, used by previews
 ├── references/
 │   ├── drawing.md                # now calls the render step
 │   ├── drafting-standard.md
+│   ├── standards-background.md   # ISO/IEC/HABS notes, moved out of the read path
-│   ├── implementation.md         # website guide, folded into CONTRIBUTING.md
-│   ├── history/                  # dated coss review record, 12 files
-│   └── *.png                     # five captures cited only by that record
 └── scripts/
     ├── export-svg.py             # + --embed-font
+    └── render.py                 # SVG or HTML → PNG, any width, light/dark
+evals/                            # the twelve briefs and a rerun script
-design-directions.md              # site decision notes, linked from nowhere
-illustration-library.md
 Inspect and deliver
-  render the candidate (no tool named)
+  python3 scripts/render.py drawing.svg [--width N] [--theme both]
+  render again after the last edit
+  a component is drawn and inspected as SVG first

plotter:check now fails if the bundled font differs from public/fonts/CalSansVF.woff2. The removed record stays readable with git show 37f3464:skills/plotter/references/history/index.md.

Evidence

  • Before: on Claude Code (Sonnet 5.5), 10 of 12 runs improvised a renderer (macOS Quick Look or Chrome), each looked once at one size, and two edited after their last render. On Codex, 0 of 12 rendered: Chrome and Quick Look both abort inside its sandbox.
    After: on Claude Code, 11 of 12 runs used render.py, and the eight static drawing runs checked all ended on a render. Codex runs the script, is told the sandbox blocked it, and reports the visual review as pending.
  • Before: without Cal Sans installed, labels rendered in Helvetica.
    After: a probe SVG whose family name no machine has rendered in Cal Sans from the embedded face, both through render.py and through export-svg.py --embed-font loaded as an <img>.
  • Removals: across 48 cold runs, 0 opened references/history, implementation.md, or NOTICE.md. After removing them, two fresh cold runs (a static drawing and an animation) completed normally.
  • Before: plotter.zip was 468 KB with the review history inside.
    After: 415 KB including the 149 KB font; 180 links in the extracted archive resolve, none dangling.
  • format:check, typecheck, and plotter:check pass. lint reports the same single error as main, in an untouched file.

Not established: one sample per brief, so no claim that drawing quality improved. render.py was run only on macOS with Chrome and Quick Look; its Linux and Windows browser paths and the rsvg-convert, resvg, Inkscape, and ImageMagick fallbacks are untested. Codex was not run with its sandbox lifted.

Merge Danger

Door: Two-way

The deleted records are recoverable from git. The font is redistributed under the SIL Open Font License 1.1, with the upstream OFL.txt from calcom/sans beside it.

Blast Radius: Download

The website's own pages are unchanged apart from two docs paragraphs. Anyone who installs after merge gets the new archive; existing installs are unaffected until replaced. Future dated feedback no longer has a folder to go in.

🤖 Generated with Claude Code

pasqualevitiello and others added 2 commits November 14, 2026 10:16
Twelve briefs, two test files, and a script that runs each brief in a
fresh Claude Code or Codex session that sees only the published archive.
Outputs go outside the checkout so the repository's instructions cannot
reach the session.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…wnload

Cold runs on a clean install showed agents improvising a renderer on
macOS and drawing blind inside Codex's sandbox, reports that cited
catalogue codes a new user has never seen, and labels falling back to
Helvetica without Cal Sans installed.

- Add scripts/render.py and call it from the drawing and animation
  workflows, including a render after the last edit and at the target
  width.
- Bundle Cal Sans with its SIL Open Font License; previews use it and
  export-svg.py gains --embed-font.
- Leave references/history and its captures out of the download, stop
  current documents linking into it, and enforce that in plotter:check.
- Move the external-standards background into its own reference and
  maintainer rules into AGENTS.md.
- Correct the skill README's "private repository" line.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 14, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
plotter Ready Ready Preview Nov 14, 2026 10:30am UTC

pasqualevitiello and others added 2 commits November 14, 2026 10:29
Across 48 cold runs no session read the dated coss review record, the
website integration guide, or the package notice, and nothing links to
the two root decision notes.

- Delete skills/plotter/references/history and its five captures. They
  remain in git history from 37f3464 and earlier.
- Delete design-directions.md and illustration-library.md.
- Fold the website integration guide into CONTRIBUTING.md, since it
  describes this repository and shipped to strangers inside the skill.
- Shorten the package notice and drop the skill README's maintainer
  section; both licenses stay.

With no record left to exclude, the download builder and the link check
return to their earlier form.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@pasqualevitiello
pasqualevitiello merged commit 491aa6f into main Nov 14, 2026
3 checks passed
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