Skip to content

feat(presenting): storytelling, humor, reveal.js 6, live demos, visuals, and CFP skills - #11

Merged
ardalis merged 3 commits into
mainfrom
feature/presenting-plugin-expansion
Sep 10, 2026
Merged

ardalis merged 3 commits into
mainfrom
feature/presenting-plugin-expansion

Conversation

@ardalis

@ardalis ardalis commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Reviews the new presenting content (the storytelling, comedic-speaking, and revealjs skills and the presentation-deck-creator agent) and brings it in line with the rest of the marketplace. It also adds three suggested skills for technical presentation content and updates the manifests, READMEs, and docs site. Split into three commits so the suggestions can be reviewed separately from the fixes.

1. Consistency and correctness fixes (fa3f1a5)

Frontmatter

  • storytelling used invocable: false, the non-existent field that ci: add workflow validating plugins and skills #8 removed everywhere else. It's now user-invocable: false; the old key fails validate_skills.py.
  • comedic-speaking and revealjs are now marked user-invocable: false, matching the other reference skills (including multimedia-presentations in this plugin).
  • Descriptions now follow the repo pattern: what the skill covers, then "Use when…".

Agent (presentation-deck-creator)

  • ⚠️ It had a hardcoded memory path into another repository (C:\dev\github-ardalis\DarkSideOfMicroservices\.claude\agent-memory\…). I removed that path, along with ~120 lines of memory boilerplate that memory: project already injects at runtime. The agent now matches technical-writer: it keeps only the "Update your agent memory" guidance.
  • It said "reveal.js 4.x" while the skill used 5.1.0. Both now use 6.x, and the agent keeps an existing deck's version unless you ask it to upgrade.
  • It now loads the plugin's skills, following the "Load and apply the x skill" convention from dotnet-testing, instead of repeating their content. It also adds color, asks about venue and existing themes, budgets talk time in the speaker notes, requires a fallback for every demo, and tells you when it couldn't render the deck.

revealjs → reveal.js 6.0.2

  • reveal.js 6 (March 2026; 6.0.2 was released today) moved every dist file: dist/reveal.esm.js → dist/reveal.mjs, and plugin/x/x.esm.js → dist/plugin/x.mjs. A new table maps each 6.x path to its 5.x equivalent so existing 5.x decks can still be edited safely. I checked every CDN URL in the skill and each one returns 200.
  • Bugs fixed:
    • The quick start loaded the core module twice.
    • The fragment-class table listed classes that don't exist (checked against 6.0.2's CSS).
    • The staggered-fragment recipe used animation-delay, but fragments animate with CSS transitions, so it had no effect.
    • import Math from '…/math.js' shadowed the JS Math global.
    • Themes cap pre code at 400px, so long code showed a scrollbar on the projector. The skill now covers this.
    • A missing note: external Markdown slides don't load from file://.

Restructuring (long SKILL.md sections moved into focused files)

Skill New supporting files
storytelling narrative-structures.md, context-guidance.md (SKILL.md keeps a structure-selection table)
comedic-speaking humor-types.md (SKILL.md keeps a styles-at-a-glance table)
revealjs theming.md, markdown-slides.md, code-slides.md; transitions, fragments, and auto-animate folded into animations-reference.md

Content tweaks: In joke-formats.md, "…memory leak, and Kevin" punched at a named colleague, which broke the skill's own rule, so it's now "…and me". I also added guidance for virtual and recorded audiences, a note about jokes in speaker notes vs. on slides, and a warning about invented statistics as hooks.

2. Suggested new resources — please review (3165439)

Skill Why it belongs here
live-demos Live vs. recorded decision table, a demo-script template, checkpoint branches, machine setup for the room, and the one-retry-then-fallback rule. It supersedes the roadmap's demo-rehearsal.
technical-visuals Readability budgets for code, diagrams, terminal output, benchmarks, and charts. Tool-agnostic; the reveal.js mechanics stay in revealjs/code-slides.md.
talk-abstracts CFP proposals: title patterns, a hook → promise → payoff abstract, verb-first takeaways, bios, and notes for reviewers, plus a worked example.

multimedia-presentations now links to all sibling skills and the agent. These three are drafts: they pass all validators, but I haven't evaluated them with subagent scenarios.

Other ideas, listed in the plugin roadmap but not built: a /presenting:deck-review command that audits an existing deck against these skills, speaker-notes, screencast-production, and a presentation-coach agent.

3. Metadata and docs (3d8137a)

  • presenting bumped to 1.1.0; description and keywords synced across plugin.json and marketplace.json.
  • Plugin and root READMEs updated.
  • New docs/content/presenting/ section: an index page plus one page per skill. It's also listed on the docs home and getting-started pages.

Test plan

  • claude plugin validate . --strict and every plugins/*/ — pass
  • python scripts/validate_skills.py — 26/26 skills valid
  • dotnet run scripts/ValidateMarketplace.cs — 6 plugins, 26 skills, 12 agents, 11 commands; all structural checks pass
  • Hugo docs build succeeds with the new presenting section
  • Every reveal.js CDN URL referenced in the skills returns HTTP 200
  • Have the agent build a sample deck and open it in a browser

Follow-ups (out of scope)

  • The docs site still calls playwright-testing by its old name testing (home page, getting-started, /testing/ section).

🤖 Generated with Claude Code

ardalis and others added 3 commits September 10, 2026 13:49
… and deck-creator agent

Bring the new presenting content in line with the rest of the marketplace:

- storytelling: `invocable: false` -> `user-invocable: false` (the former is
  not a Claude Code field and fails validate_skills.py); split the structure
  catalog and per-format guidance into narrative-structures.md and
  context-guidance.md
- comedic-speaking, revealjs: mark as background skills
  (`user-invocable: false`) like the other reference skills
- comedic-speaking: move the humor-type catalog to humor-types.md; add
  virtual/recorded audience guidance; replace a joke aimed at a named
  colleague with a self-deprecating one
- revealjs: target reveal.js 6.0.2 (6.x moved every dist path; the 5.1.0
  skeleton also loaded the core module twice), add a 5.x vs 6.x path table,
  split into theming, markdown-slides, code-slides, and animations
  references; fix the fragment class table, the staggered-fragment recipe
  (fragments use transitions, not animations), and the `import Math`
  shadowing bug
- presentation-deck-creator: remove a hardcoded memory path into another
  repository and the memory boilerplate that `memory: project` already
  injects; align it on reveal.js 6 and have it load the plugin's skills

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

Suggested additions for technical presentation content, submitted for review:

- live-demos: live vs. recorded, demo scripts, checkpoint branches, machine
  setup for the room, narrating, and recovering from a failed demo
- technical-visuals: readability budgets and guidance for code, diagrams,
  terminal output, benchmarks, and charts on slides (tool-agnostic)
- talk-abstracts: CFP proposals - titles, abstracts, takeaways, bios, and
  notes for reviewers
- multimedia-presentations: link to the sibling skills and the agent, and add
  a "Use when" trigger to its description

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

- bump presenting to 1.1.0 and sync its description and keywords in
  plugin.json and marketplace.json
- document all seven skills and the agent in the plugin README; refresh the
  roadmap
- add a presenting section to the Hugo docs site with a page per skill, and
  list the plugin on the docs home and getting-started pages

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ardalis
ardalis merged commit 1fcf66b into main Sep 10, 2026
1 check 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