Files
pm-claude-skills/plugins/pm-delivery/skills/sprint-planning/SKILL.md
T
Claude 760f979365 Add cross-tool positioning, Python helpers, tiers, and hygiene docs
Five improvements to position the library as a serious engineering project:

1. Cross-tool compatibility — new README "Works With" section honestly
   documenting where skills run (Claude Code natively; SKILL.md bodies
   port to other agents and chat LLMs as system prompts).

2. Python helper scripts (stdlib-only) for the three strongest skills:
   - sprint-planning: capacity_calculator.py (recommended commitment)
   - rice-prioritisation: rice_calculator.py (ranks, flags quick wins/moonshots)
   - cs-health-scorecard: health_score.py (weighted total + RAG)
   Each is wired into its SKILL.md and synced to the plugin copies.

3. Explicit skill tiering — TIERS.md + README section marking 46
   Production-Ready skills and calling out Experimental (external-dependency)
   ones; everything else is Stable.

4. Repository hygiene — new CHANGELOG.md (Keep a Changelog format) and
   SKILL-AUTHORING-STANDARD.md; refreshed SECURITY.md version table and
   helper-script disclosure; added .gitignore.

5. Related Projects — README section linking to alirezarezvani/claude-skills
   and the major awesome-claude-skills / awesome-claude-code lists.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
2026-06-17 07:48:48 +00:00

5.3 KiB
Raw Blame History

name, description
name description
sprint-planning Structure and facilitate sprint planning sessions. Use when asked to plan a sprint, organise backlog items, assign story points, create sprint goals, or prepare sprint planning agendas. Produces a sprint goal, velocity-calibrated backlog, capacity plan, risk flags, and a structured sprint planning meeting agenda.

Sprint Planning Skill

Transform raw backlog items into a structured, achievable sprint with clear goals, velocity-calibrated scope, and team-ready output.

What This Skill Produces

  • Sprint Goal — single, outcome-focused sentence the whole team can rally around
  • Sprint Backlog — prioritised list of user stories with story point estimates and acceptance criteria
  • Capacity Plan — team availability breakdown accounting for holidays, meetings, and focus time
  • Sprint Planning Agenda — structured 2-hour meeting agenda with timings
  • Risk Flags — blockers or dependencies that could derail the sprint

Required Inputs

Ask for (if not already provided):

  • Sprint duration (1 or 2 weeks)
  • Team size and velocity (average story points per sprint)
  • Top 35 backlog items or epics to pull from
  • Any known absences, holidays, or team events
  • Previous sprint's incomplete items (carry-overs)

Sprint Goal Formula

Use this structure:

"This sprint we will [deliver X outcome] so that [user/business benefit], measured by [success indicator]."

Never write sprint goals as task lists. Always outcome-first.

Story Point Calibration

Complexity Points Description
Trivial 1 Clearly understood, no unknowns
Small 2 Straightforward, minor effort
Medium 3 Some complexity, clear path
Large 5 Complex, needs design or research
Very Large 8 High uncertainty, may need splitting
Epic 13+ Too large — must be split before sprint

Flag any item estimated at 8+ and recommend splitting.

Capacity Formula

Available capacity = (Team size × Sprint days × Focus hours/day) × Availability factor
Focus hours/day: 6 (accounting for meetings, Slack, admin)
Availability factor: 0.70.85 depending on holidays/events
Story points to commit = Historical velocity × Availability factor

Programmatic Helper

This skill ships with a stdlib-only Python script that computes capacity instead of estimating it by hand. Use it whenever the team's numbers are known — it applies the availability and 80% commit-ratio rules consistently.

# Quick estimate from flags
python3 scripts/capacity_calculator.py --team 5 --days 10 --velocity 30 --availability 0.8 --carryover 5

# Detailed estimate from per-member availability (JSON via stdin or --input file.json)
echo '{"sprint_days":10,"historical_velocity":40,"carryover_points":8,
       "members":[{"name":"Ada","available_days":10},{"name":"Linus","available_days":7}]}' \
  | python3 scripts/capacity_calculator.py --input -

The script returns available focus hours, a velocity figure adjusted for real availability, the recommended commitment (capped at 80% of velocity), and the remaining capacity for new work after carry-overs. Run it first, then build the sprint backlog to fit the recommended number. Add --json to pipe the result into other tooling.

Output Format

Sprint [N] — [Start Date] to [End Date]

Sprint Goal:

[Goal statement]

Team Capacity: [X] story points available (based on [Y] team members, [Z]% availability)

Sprint Backlog:

Priority Story Points Owner Acceptance Criteria
1 [Story title] [N] [Team member] [When X then Y]

Carry-Overs from Previous Sprint:

  • [Item] — Reason for carry-over: [brief explanation]

Risks & Dependencies:

  • [Risk description] → Mitigation: [action]

Sprint Planning Agenda:

  • 00:0000:10 — Review sprint goal and team capacity
  • 00:1000:40 — Walk through backlog items, confirm estimates
  • 00:4001:20 — Assign stories, identify dependencies
  • 01:2001:50 — Review acceptance criteria per story
  • 01:5002:00 — Confirm sprint commitment and close

Guidelines

  • Always challenge stories missing acceptance criteria — flag them explicitly
  • Recommend the team commits to 80% of available capacity, not 100%
  • If no velocity data is provided, assume 2030 points for a 5-person team as a starting point
  • Highlight any story with unclear ownership as a blocker

Quality Checks

  • Sprint goal is outcome-focused (not "implement X" — something like "users can do Y")
  • Team capacity is calculated using actual availability, not theoretical 100%
  • Every story has an acceptance criterion (flag any that don't)
  • Stories estimated at 8+ points are flagged for splitting
  • Carry-overs from last sprint are accounted for in capacity

Anti-Patterns

  • Do not write sprint goals as task lists — goals must be outcome-focused and scoreable pass/fail at sprint end
  • Do not commit to 100% of available capacity — always recommend 80% to preserve slack for unplanned work
  • Do not carry stories with no acceptance criteria into the sprint — flag them as blockers before committing
  • Do not allow stories estimated at 8+ points into the sprint without splitting them first
  • Do not ignore carry-over items when calculating capacity — they consume capacity and must be accounted for before new work is pulled in