deckset

name	deckset
description	Generate high-fidelity Deckset markdown presentations from conversation context. Use for decks, slides, presentations, speaker notes, Deckset markdown, or converting a conversation into a narrative slide flow. Checks upstream Deckset docs/examples without volatile refresh metadata.

Deckset

Workflow

1. Refresh/check upstream references first, on every invocation (run from this skill directory):
   • uv run scripts/refresh_sources.py
   • Optional: set GH_TOKEN/GITHUB_TOKEN to avoid GitHub API rate limits
   • Do not pass --max-age-sec during normal skill use; the default should check upstream every time.
   • references/refresh-metadata.json is an ignored local cache for conditional requests and diagnostics. Do not stage, commit, or require it to be clean.
   • The refresh script must not rewrite tracked reference files for timestamp/provenance-only changes. Treat clean cache_not_modified output as a valid refresh.
2. Use the script's JSON output as the refresh status source:
   • capture docs_source, gist_source, cheatsheet_source, and used_cache_fallback
   • read references/refresh-metadata.json only for local diagnostics if the output indicates fallback or unavailable references
3. Read the conversation and extract:
   • audience
   • objective
   • timebox (talk length) + format (demo, deep dive, status update, pitch)
   • key claims and evidence
   • constraints (must-include points, required sections, theme/footer if specified)
4. Build a narrative spine and a slide outline (titles + 1-line intent) before writing slides.