// Internal publisher module for /codeck. Exports deck to PDF or PPTX with post-export QA. User-facing export requests should enter through /codeck; this skill defines the export behavior.
Editor role. Reads local materials, asks narrative questions, plans story arc. Outputs $DECK_DIR/deck.md as the sole content source. Use whenever the user says "outline", "plan slides", "organize materials", "structure", "table of contents", "narrative", or wants to structure content into a presentation.
Reviewer role. Opens rendered HTML, inspects every slide visually, fixes problems in custom.css or slides.html and rebuilds through build-html.sh. Use whenever the user says "review", "QA", "check slides", "inspect", "audit", "proofread", or wants feedback on a rendered deck.
Designer role. Reads deck.md, generates a single HTML presentation file with CSS design system + JS slide engine + per-slide content. Accepts visual references (URLs, screenshots, design specs) and extracts design signals to inform the isomorphic mapping. Use whenever the user says "design slides", "generate deck", "generate the deck", "build slides", "visual style", "reference this style", "like this design", "design", "generate slides", "visual style", "reference this style", or wants to turn an outline into actual slides.
codeck entry point. Scans local files for materials, shows pipeline dashboard with diagnostic intelligence, guides user to the next step. Use when the user says "codeck", "new deck", "make a presentation", "make a deck", "new slides", "build a presentation", "export", "speech", "script", or wants to start or continue a presentation project. /codeck is the user-facing entry; legacy sub-skills are internal modules.
Internal speech module for /codeck. Reads deck content, asks about style and duration only when missing, generates a verbatim speech transcript with stage directions. Outputs $DECK_DIR/speech.md.
| name | codeck-export |
| version | 2.1.0 |
| description | Internal publisher module for /codeck. Exports deck to PDF or PPTX with post-export QA. User-facing export requests should enter through /codeck; this skill defines the export behavior. |
Minimum conversation, maximum output. Export the deck to the user's format.
@export owns PDF/PPTX output and export QA.
Write boundaries:
$DECK_DIR/review.md or $DECK_DIR/MEMORY.md$DECK_DIR/roles/export.md, $DECK_DIR/tasks/tasks.md, and $DECK_DIR/channel/YYYY-MM-DD.mddeck.md, DESIGN.md, custom.css, slides.html, or speech.md$DECK_DIR/threads/threads.mdDECK_DIR="$HOME/.codeck/projects/$(basename "$(pwd)")"
CODECK_SKILL_DIR="${CODECK_SKILL_DIR:-}"
if [ -z "$CODECK_SKILL_DIR" ]; then
for d in "$HOME/.agents/skills/codeck" "$HOME/.codex/skills/codeck" "$HOME/.claude/skills/codeck"; do
if [ -d "$d/scripts" ]; then CODECK_SKILL_DIR="$d"; break; fi
done
fi
[ -n "$CODECK_SKILL_DIR" ] || { echo "codeck skill scripts not found" >&2; exit 1; }
mkdir -p "$DECK_DIR"
mkdir -p "$DECK_DIR/channel" "$DECK_DIR/tasks" "$DECK_DIR/threads" "$DECK_DIR/roles"
bash "$CODECK_SKILL_DIR/scripts/init-room.sh" "$DECK_DIR"
bash "$CODECK_SKILL_DIR/scripts/status.sh" "$DECK_DIR"
Read $DECK_DIR/MEMORY.md, active rows in $DECK_DIR/tasks/tasks.md, and open rows in $DECK_DIR/threads/threads.md. Do not read channel/YYYY-MM-DD.md unless debugging history.
Gate check: if no assembled HTML exists (./*-r*.html), run /codeck to generate/rebuild the deck first.
Before export, claim the work ticket:
@orchestrator
Owner: @export. Task: export latest HTML and run export QA.
@export
I claim the export pass. I will write PDF/PPTX outputs and record any source defects as threads.
Append the exchange to today's channel file and update tasks/tasks.md.
Export Format is one allowed Decision Ask moment under /codeck.
Use the shared /codeck Decision Ask Policy. Skip Decision Ask when the user names a target:
PDF, print, save as PDF → export PDFPPTX, PowerPoint, slides file → export PPTXall, both → export PDF and PPTXIf the user only says "export", create a non-blocking D-YYYYMMDD-NN decision in threads/threads.md and render once:
codeck needs the export format.
Current read: HTML already exists as the audience preview.
I suggest PDF because it preserves the visual layout and is easiest to share.
A) PDF (recommended)
B) PPTX
C) PDF + PPTX
If the user does not answer or structured AskUser UI is unavailable, export PDF and write assumed default to MEMORY.md.
Do not offer HTML as an export choice. HTML is the preview/source artifact.
Find the HTML file (./*-r*.html in the user's project directory), derive baseName.
Already exists. Open in browser, F for fullscreen, arrows to navigate.
Use Playwright for WYSIWYG PDF:
npx playwright install chromium 2>/dev/null || true
import { chromium } from 'playwright';
import { resolve } from 'path';
import { readdirSync } from 'fs';
import { pathToFileURL } from 'url';
const html = readdirSync('.').find(f => /-r\d+\.html$/.test(f));
const baseName = html.replace('.html', '');
const browser = await chromium.launch();
const page = await browser.newPage();
await page.goto(pathToFileURL(resolve(html)).toString(), { waitUntil: 'networkidle' });
await page.emulateMedia({ media: 'screen' });
await page.pdf({
path: `${baseName}.pdf`,
printBackground: true,
preferCSSPageSize: true,
margin: { top: '12mm', right: '12mm', bottom: '12mm', left: '12mm' }
});
await browser.close();
console.log(`done: ${baseName}.pdf`);
.media-poster elements in slides.html are video/audio placeholders. Original file paths are in the caption and deck.md asset manifest.
Default: keep placeholders in export. If user says "embed video", extract path from caption, use slide.addMedia({ path: "..." }) for PPTX.
Option A (recommended): LibreOffice
CODECK_EXPORT_DIR="${CODECK_EXPORT_DIR:-}"
if [ -z "$CODECK_EXPORT_DIR" ]; then
for d in "$HOME/.agents/skills/codeck-export" "$HOME/.codex/skills/codeck-export" "$HOME/.claude/skills/codeck-export"; do
if [ -d "$d/pptx/scripts" ]; then CODECK_EXPORT_DIR="$d"; break; fi
done
fi
[ -n "$CODECK_EXPORT_DIR" ] || { echo "codeck-export scripts not found" >&2; exit 1; }
EXPORT_SCRIPTS="$CODECK_EXPORT_DIR/pptx/scripts"
python "$EXPORT_SCRIPTS/office/soffice.py" --headless --convert-to pdf ./*-r*.html
python "$EXPORT_SCRIPTS/office/soffice.py" --headless --convert-to pptx ./*-r*.html
Option B (fallback): screenshot embed
If soffice unavailable, use Playwright to screenshot each page, then PptxGenJS to embed screenshots as slides. Read $CODECK_EXPORT_DIR/pptx/pptxgenjs.md for the API.
Assume the export has problems. Find them.
Check: pages complete (no truncation), backgrounds render, fonts display correctly.
Generate thumbnails:
CODECK_EXPORT_DIR="${CODECK_EXPORT_DIR:-}"
if [ -z "$CODECK_EXPORT_DIR" ]; then
for d in "$HOME/.agents/skills/codeck-export" "$HOME/.codex/skills/codeck-export" "$HOME/.claude/skills/codeck-export"; do
if [ -d "$d/pptx/scripts" ]; then CODECK_EXPORT_DIR="$d"; break; fi
done
fi
[ -n "$CODECK_EXPORT_DIR" ] || { echo "codeck-export scripts not found" >&2; exit 1; }
EXPORT_SCRIPTS="$CODECK_EXPORT_DIR/pptx/scripts"
python "$EXPORT_SCRIPTS/thumbnail.py" ./*-r*.pptx
Convert to images for detailed check:
python "$EXPORT_SCRIPTS/office/soffice.py" --headless --convert-to pdf ./*-r*.pptx
pdftoppm -jpeg -r 150 *.pdf slide-check
Use subagent to visually inspect screenshots. Focus on: overlapping elements, text overflow, uneven spacing, low-contrast text, differences from HTML original.
At least one fix-verify cycle before declaring done.
If QA finds a source defect, do not edit source files directly. Add a thread with the affected artifact and suggested owner, then hand off to @design or @review.
After export:
MEMORY.md Active Context, Latest Channel Summary, Task Index, and Artifacts.@export task done in tasks/tasks.md.Export done. Output:
{baseName}.pdf/{baseName}.pptx@export I exported the latest HTML, ran QA, and recorded output paths in memory.
Speech script:
/codeck speech script. Overview:/codeck.