speckit-deck-render

Render council defense deck markdown into .pptx files via a deterministic Python script.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-deck-render-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-deck-render
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/extensions/deck-render/skills/speckit-deck-render
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-deck-render-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx.

What problem does it solve? Converting a reviewed council defense deck from markdown into a PowerPoint file normally requires manual copy-paste or an LLM rewriting content, which risks the rendered deck diverging from what was actually reviewed. This Skill performs a fully mechanical, model-free transform so the .pptx always reflects the reviewed markdown exactly. ## Core Features & Use Cases - On-demand deck rendering: Shells out to render.py to convert council/defense-deck/*.md into renders/<deck>.pptx, only when a human explicitly asks — nothing in the pipeline triggers it automatically. - Profile-aware deck selection: An explicit technical, overview, or both argument overrides profile.yaml's deck_render key entirely; with no argument, the profile decides, and none renders nothing. - Graceful degradation: A missing python-pptx toolchain or a transform error degrades to a disclosed per-deck failure without blocking the council gate or any pipeline phase, and --validate-profile checks the deck_render key without rendering. - Use Case: After a council defense, run the command with both to produce technical and overview .pptx decks from the reviewed markdown for stakeholder distribution. ## Quick Start Ask the assistant to render the council defense deck for the current feature into a PowerPoint file, optionally specifying technical, overview, or both.

Frequently Asked Questions about speckit-deck-render

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert markdown slides to a PowerPoint .pptx file?

Invoke the render command with an optional deck selector such as technical, overview, or both. The skill runs render.py, which transforms the defense deck markdown into a .pptx under the renders directory without any model involvement.

How do I render a deck for a specific feature instead of the active one?

Pass --feature followed by the feature directory path, and it is forwarded verbatim to render.py. Without it, the script resolves the feature from .specify/feature.json or the current git branch.

Does rendering decks require python-pptx to be installed?

python-pptx is optional. If it is absent, the affected deck's render degrades to a disclosed per-deck failure rather than blocking the command, and the markdown remains the artifact of record.

What happens if profile.yaml has an invalid deck_render value?

An out-of-enum deck_render value or an unreadable profile.yaml is a hard failure with exit code 3, and nothing is written. It never silently degrades to none; use --validate-profile to check the key without rendering.

Will a failed deck render block the council gate or pipeline?

No. Non-zero exit codes from this command never block any pipeline phase. The per-deck outcome is disclosed as rendered, failed with a reason, or skipped, and the source markdown stays untouched.