Install any skill in seconds. Free to start, no credit card required.
Get Started Free →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.
.claude/skills/hiyeshu-codeck-export/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-10 | ✗→✓ | ▲ Improved | 79% | 0% |
| case-12 | ✗→✓ | ▲ Improved | 79% | 0% |
| case-14 | ✗→✓ | ▲ Improved | 63% | 0% |
| case-15 | ✗→✓ | ▲ Improved | 151% | 0% |
| case-17 | ✗→✓ | ▲ Improved | 198% | 0% |
<!-- INPUT]: Depends on latest assembled HTML, MEMORY.md, tasks/tasks.md, and threads/threads.md. OUTPUT]: Provides PDF/PPTX exports and export QA notes. POS]: skills/codeck-export lane; publishes the reviewed deck from room state to final artifacts. PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md -->
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.mdbashDECK_DIR="$HOME/.codeck/projects/$(basename "$(pwd)")" CODECK_SKILL_DIR="${CODECK_SKILL_DIR:-}" if [ -z "$CODECK_SKILL_DIR" ]; then for d in \ "${CLAUDE_PLUGIN_ROOT}/skills/codeck" \ "$HOME"/.claude/plugins/cache/*/codeck/*/skills/codeck \ "$HOME"/.codex/plugins/cache/*/codeck/*/skills/codeck \ "$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; set CODECK_SKILL_DIR" >&2; exit 1; } . "$CODECK_SKILL_DIR/scripts/resolve-dirs.sh" 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:
markdown@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:
textcodeck 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:
bashnpx playwright install chromium 2>/dev/null || true
javascriptimport { 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
bashCODECK_SKILL_DIR="${CODECK_SKILL_DIR:-}" if [ -z "$CODECK_SKILL_DIR" ]; then for d in \ "${CLAUDE_PLUGIN_ROOT}/skills/codeck" \ "$HOME"/.claude/plugins/cache/*/codeck/*/skills/codeck \ "$HOME"/.codex/plugins/cache/*/codeck/*/skills/codeck \ "$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; set CODECK_SKILL_DIR" >&2; exit 1; } . "$CODECK_SKILL_DIR/scripts/resolve-dirs.sh" [ -n "${CODECK_EXPORT_DIR:-}" ] || { echo "codeck-export not found; set CODECK_EXPORT_DIR" >&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:
bashCODECK_SKILL_DIR="${CODECK_SKILL_DIR:-}" if [ -z "$CODECK_SKILL_DIR" ]; then for d in \ "${CLAUDE_PLUGIN_ROOT}/skills/codeck" \ "$HOME"/.claude/plugins/cache/*/codeck/*/skills/codeck \ "$HOME"/.codex/plugins/cache/*/codeck/*/skills/codeck \ "$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; set CODECK_SKILL_DIR" >&2; exit 1; } . "$CODECK_SKILL_DIR/scripts/resolve-dirs.sh" [ -n "${CODECK_EXPORT_DIR:-}" ] || { echo "codeck-export not found; set CODECK_EXPORT_DIR" >&2; exit 1; } EXPORT_SCRIPTS="$CODECK_EXPORT_DIR/pptx/scripts" python "$EXPORT_SCRIPTS/thumbnail.py" ./*-r*.pptx
Convert to images for detailed check:
bashpython "$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.
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-04 | fail→fail | 4,587 | 12,691 | +177% | 1 | 1 | 0% | 128 | 3,335 | +2505% | 0 | 0 | — |
case-10 | fail→pass | 12,341 | 2,958 | -76% | 1 | 1 | 0% | 1,651 | 2,961 | +79% | 0 | 0 | — |
case-01 | fail→fail | 16,071 | 11,501 | -28% | 1 | 1 | 0% | 2,448 | 3,343 | +37% | 0 | 0 | — |
case-02 | fail→fail | 4,609 | 10,603 | +130% | 1 | 1 | 0% | 213 | 3,106 | +1358% | 0 | 0 | — |
case-03 | fail→fail | 13,681 | 11,405 | -17% | 1 | 1 | 0% | 2,055 | 3,237 | +58% | 0 | 0 | — |
case-05 | fail→fail | 25,155 | 12,412 | -51% | 1 | 1 | 0% | 3,964 | 3,202 | -19% | 0 | 0 | — |
case-06 | fail→fail | 17,218 | 13,002 | -24% | 1 | 1 | 0% | 2,861 | 3,299 | +15% | 0 | 0 | — |
case-07 | fail→fail | 7,292 | 2,659 | -64% | 1 | 1 | 0% | 1,139 | 3,024 | +165% | 0 | 0 | — |
case-08 | fail→fail | 4,634 | 25,180 | +443% | 1 | 1 | 0% | 554 | 3,093 | +458% | 0 | 0 | — |
case-09 | fail→fail | 6,845 | 12,739 | +86% | 1 | 1 | 0% | 867 | 3,130 | +261% | 0 | 0 | — |
case-11 | pass→pass | 8,977 | 4,191 | -53% | 1 | 1 | 0% | 1,341 | 3,133 | +134% | 0 | 0 | — |
case-12 | fail→pass | 10,833 | 3,018 | -72% | 1 | 1 | 0% | 1,689 | 3,022 | +79% | 0 | 0 | — |
case-13 | pass→pass | 15,998 | 4,666 | -71% | 1 | 1 | 0% | 2,308 | 3,137 | +36% | 0 | 0 | — |
case-14 | fail→pass | 13,783 | 5,183 | -62% | 1 | 1 | 0% | 2,030 | 3,302 | +63% | 0 | 0 | — |
case-15 | fail→pass | 26,823 | 3,280 | -88% | 1 | 1 | 0% | 1,195 | 2,999 | +151% | 0 | 0 | — |
case-16 | pass→pass | 10,290 | 4,511 | -56% | 1 | 1 | 0% | 1,488 | 3,192 | +115% | 0 | 0 | — |
case-17 | fail→pass | 6,679 | 2,287 | -66% | 1 | 1 | 0% | 963 | 2,868 | +198% | 0 | 0 | — |
case-18 | fail→fail | 8,171 | 4,666 | -43% | 1 | 1 | 0% | 1,167 | 3,274 | +181% | 0 | 0 | — |
case-19 | fail→fail | 15,743 | 2,317 | -85% | 1 | 1 | 0% | 2,444 | 2,852 | +17% | 0 | 0 | — |
case-20 | pass→fail | 10,905 | 2,760 | -75% | 1 | 1 | 0% | 1,606 | 2,908 | +81% | 0 | 0 | — |
case-21 | pass→pass | 8,226 | 2,997 | -64% | 1 | 1 | 0% | 1,169 | 2,993 | +156% | 0 | 0 | — |
case-22 | pass→pass | 15,598 | 2,386 | -85% | 1 | 1 | 0% | 2,384 | 2,847 | +19% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted, and 13 counted toward the lift figure. The other 9 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +18 percentage points is the difference between those two pass rates over the 13 comparable cases. 2 cases got worse with the skill loaded, and they are included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.