sprint-summary-pdf

name	sprint-summary-pdf
description	Generate per-sprint PDF summaries with a card layout from docs/sprints. Use when the user asks for sprint summaries, sprint recap PDFs, shareable sprint story cards, or to drop PDFs into each sprint folder.

Sprint Summary PDF

Use this skill to generate a clean PDF per sprint, saved inside each sprint folder.

Quickstart

• All sprints (default): python skills/sprint-summary-pdf/scripts/generate_sprint_summary_pdf.py
• Single sprint: python skills/sprint-summary-pdf/scripts/generate_sprint_summary_pdf.py --sprint sprint-11

Inputs

• docs/sprints/*/README.md
• docs/sprints/*/PRD.md
• docs/sprints/*/*SUMMARY*.md
• docs/sprints/*/completion-summary*.md
• docs/sprints/*/mindmap*.md

Output

• Default filename: SPRINT_SUMMARY_CARDS.pdf
• Save inside each sprint folder, for example:
  • docs/sprints/sprint-11/SPRINT_SUMMARY_CARDS.pdf

Content extraction

For each sprint folder, extract:

• Title and sprint name
• Dates or time window (if present)
• Goal or theme (from README or PRD)
• Key wins or delivered features
• Risks or known gaps
• Next steps or transition notes
• Metrics or performance highlights (if present)

If a sprint is missing a summary file, synthesize a short summary from README and PRD only.

Layout and style

• Use a grid of cards (4 to 6 cards per sprint).
• Visual tone inspired by the Pixel Detective frontend:
  • dark base, high contrast text
  • cyan or teal accent lines
  • rounded cards, subtle shadows
  • bold section headers
• Keep it readable at a glance. Each card should be 3 to 6 bullets.
• Include a small header with sprint name, status, and dates.

PDF generation approach

• Build a single HTML per sprint with inline CSS.
• Render to PDF using WeasyPrint when available; otherwise leave HTML for manual export.
• Do not depend on running services.

Scope control

• If user asks for a single sprint, only generate that sprint PDF.
• If user asks for all, iterate every sprint folder under docs/sprints/.

Template and script

• Template: skills/sprint-summary-pdf/assets/sprint_cards_template.html
• Script: python skills/sprint-summary-pdf/scripts/generate_sprint_summary_pdf.py (defaults to --all)
• Single sprint: --sprint sprint-11

Notes

• If a sprint folder has no bullet lists, generate a single Summary card using the first paragraph of README/PRD.
• Prefer README for narrative, PRD for goals, and completion summaries for wins and gaps.
• Keep cards concise; trim long bullets and drop low-signal items.