Skip to content

beautiful_deck + tikz: cross-skill consolidation, script extractions, label-clearance hardening#18

Open
nsmiller2501 wants to merge 7 commits into
scunning1975:mainfrom
nsmiller2501:followup/deck-tikz-audit
Open

beautiful_deck + tikz: cross-skill consolidation, script extractions, label-clearance hardening#18
nsmiller2501 wants to merge 7 commits into
scunning1975:mainfrom
nsmiller2501:followup/deck-tikz-audit

Conversation

@nsmiller2501
Copy link
Copy Markdown

Summary

Follow-on to #9. Continues the paired-skill work: extracts deterministic scripts out of both /beautiful_deck and /tikz, hardens /tikz label clearance, and consolidates cross-skill duplication so the two skills share a single source of truth.

What changed

Script extractions

  • New .claude/skills/tikz/scripts/audit_passes.sh: the shell-based pre-check / picture-count / candidate-section indexer that previously lived inline in SKILL.md. /tikz now invokes it at Step 2 (audit) and Step 5 (recompile verification).
  • New .claude/skills/beautiful_deck/scripts/compile_loop.sh: the deterministic pdflatex compile-and-classify loop that previously lived inline in /beautiful_deck's compile step. Returns a structured exit signal so the orchestrator can decide whether to re-run or escalate.

Both skills' allowed-tools lists have been augmented with the new script paths.

Cross-skill audit (commit d088e8d-derived)

  • Removes duplicated TikZ-rule prose from /beautiful_deck Step 4.4; the canonical formulas / clearance tables now live only in /tikz/tikz_rules.md and are referenced from both skills.
  • Extracts the theme_path_b.md, alternative_formats.md, graphics_audit_prompt.md, and rhetoric_audit_prompt.md material out of SKILL.md into modal sibling files that load on demand.
  • Drops the in-skill duplicate of rhetoric_of_decks_full_essay.md from .claude/skills/beautiful_deck/ (the canonical lives at presentations/rhetoric_of_decks_full_essay.md).

/tikz label-clearance hardening (commit 7d46e16-derived)

  • Strengthens the Pass-2 / Pass-5 clearance language in tikz_rules.md: minimum edge-label-to-arrow gap raised, "label touches arrow shaft" promoted from advisory to hard failure.
  • Adds a small worked example to make the gap formula unambiguous.

/beautiful_deck trim (commit 7834716-derived)

  • Trims the Reference section and Step 6 to remove material that duplicated /tikz after the cross-skill consolidation.

Why

Testing

  • Ran /beautiful_deck end-to-end against a small academic-seminar deck and confirmed compile_loop.sh produces the same classify-and-loop behavior as the prior inline steps.
  • Ran /tikz against a deck with known label/arrow collisions and confirmed audit_passes.sh surfaces the same candidate sections as the prior inline shell snippets.
  • Verified beautiful_deck Step 4.4 still resolves the tikz_rules.md reference correctly after the consolidation.

nsmiller2501 and others added 7 commits May 8, 2026 11:40
…tions

Cross-skill (the paired-session win):
- Lift Beamer parameterized-style rule into tikz_rules.md as Rule 9
- Collapse beautiful_deck Step 4.4 (Rules 1-6, ~42L) to a pointer
- tikz_rules.md is now single source of truth for both generation + audit

Modal extractions in beautiful_deck (loaded only when triggered):
- theme_path_b.md: Step 1 sub-steps 1.1-1.6 (original-design path)
- alternative_formats.md: Q5 non-Beamer formats
- rhetoric_audit_prompt.md: verbatim Step 7 sub-agent prompt
- graphics_audit_prompt.md: verbatim Step 8 sub-agent prompt

tikz trim:
- Pass 6 debug bounding-box pass extracted to debug_bounding_box.md
- Known Limitations table moved to tikz_rules.md

Line counts: beautiful_deck/SKILL.md 657 -> 546; tikz/SKILL.md 124 -> 101.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Reference section (Three Laws + Aristotelian triad, ~20L) collapsed to
  pointer at rhetoric_of_decks.md §I, §II — duplication, not load-bearing
- Step 6 /tikz invocation trimmed to short pointer (the /tikz skill
  describes its own protocol; restating it here was duplication)
- Delete .claude/skills/beautiful_deck/rhetoric_of_decks_full_essay.md.
  Identical copy already exists at deprecated/presentations/. Update
  both READMEs to reference the archived path.

Line counts: beautiful_deck/SKILL.md 546 -> 507.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@nsmiller2501 nsmiller2501 marked this pull request as ready for review May 23, 2026 22:43
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