Agent skill

Sprint Status Snapshot

by Donchitos in Donchitos/Claude-Code-Game-Studios

Gives a fast, read-only sprint snapshot with burndown and emerging risks in under 30 lines, plus at most one concrete recommendation.

MITAuto-check passedProduct & Project Management

Install Sprint Status Snapshot

skills CLI
$ npx skills add Donchitos/Claude-Code-Game-Studios --skill sprint-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Donchitos/Claude-Code-Game-Studios sprint-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Donchitos/Claude-Code-Game-Studios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/sprint-status .claude/skills/sprint-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sprint-status
GitHub stars
26k
Token cost
~3k tokens
SKILL.md length
1,399 words
Files
1
Skills in repo
73
Repo updated
First seen
Licence
MIT

At a glance

Gives a fast, read-only sprint snapshot with burndown and emerging risks in under 30 lines, plus at most one concrete recommendation.

  • Works in 6 steps: Find the Sprint → Calculate Days Remaining → Scan Story Status → …
  • Getting a quick read on how the current sprint is going
  • SKILL.md covers 1. Find the Sprint, 2. Calculate Days Remaining, 3. Scan Story Status and 4. Burndown Assessment, plus 3 more sections
  • Calls bash

What it does

This is a situational-awareness check, not a sprint review. It finds the sprint file in `production/sprints/`, by number if you pass one (for example `/sprint-status 3`) or else the most recently modified file, then scans the story files for status markers and prints a concise snapshot with burndown and emerging risks. The `story_granularity` setting changes how fine the burndown read is, from feature-sized chunks to task-sized and down to AC-sized pieces.

The skill never proposes changes or writes files. At the minimal workflow tier there are no sprints by design, so it reads a story-status script's list instead and prints how many stories in the build order are complete, plus the next story, recommending `/story-done` for a story in review and `/dev-story` for one in progress or to do. Blocked stories are named with their blocker and are never next.

When your agent uses it

  • Getting a quick read on how the current sprint is going
  • Spotting emerging risks mid-sprint without a full review
  • Finding the next story to pick up in a sprintless minimal-tier project

Example prompts

  • “How is the sprint going. Give me the burndown and any risks.”
  • “/sprint-status 3”
  • “Show me which story is next in our build order.”

Requirements

  • Sprint files in `production/sprints/` or the story-status script
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash(bash "*/.claude/skills/sprint-status/../../hooks/yaml-helper.sh" resolve_config *), Bash(bash "*/.claude/skills/sprint-status/../../scripts/story-status.sh"), Bash(bash .claude/scripts/story-status.sh*)

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Find the Sprint
  2. Calculate Days Remaining
  3. Scan Story Status
  4. Burndown Assessment
  5. Output
  6. Fast Escalation Rules

What it can do on your machine

Read from SKILL.md and the folder at commit be8993b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Bash(bash "*/.claude/skills/sprint-status/../../hooks/yaml-helper.sh" resolve_config *)
    • Bash(bash "*/.claude/skills/sprint-status/../../scripts/story-status.sh")
    • Bash(bash .claude/scripts/story-status.sh*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sprint Status Snapshot loads about 3k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 1,399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Donchitos/Claude-Code-Game-Studios at commit be8993b, republished under its MIT licence (© Donchitos). 1,399 words, ~3,014 tokens.

Download SKILL.mdSave it as .claude/skills/sprint-status/SKILL.md (or your agent's skills folder).
name
sprint-status
description
Fast, concise sprint snapshot — burndown and emerging risks for situational awareness. 'How is the sprint going?'
allowed-tools
Read, Glob, Grep, Bash(bash "*/.claude/skills/sprint-status/../../hooks/yaml-helper.sh" resolve_config *), Bash(bash "*/.claude/skills/sprint-status/../../scripts/story-status.sh"), Bash(bash .claude/scripts/story-status.sh*)
argument-hint
[sprint-number or blank for current]
user-invocable
true
model
haiku

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys story_granularity,workflow

Sprint Status

This is a fast situational awareness check, not a sprint review. It reads the current sprint plan and story files, scans for status markers, and produces a concise snapshot in under 30 lines. For detailed sprint management, use /sprint-plan update or /milestone-review.

This skill is read-only. It never proposes changes, never asks to write files, and makes at most one concrete recommendation.

story_granularity — it sets the grain of the burn-down read: feature-sized chunks at coarse (the default, via rigor: minimal), task-sized at balanced (rigor: standard), AC-sized at fine.


1. Find the Sprint

Argument: $ARGUMENTS (blank = use current sprint)

  • If an argument is given (e.g., /sprint-status 3), search production/sprints/ for a file matching sprint-003.md, sprint-03.md, sprint-3.md, or similar (/sprint-plan writes three digits). Report which file was found.
  • If no argument is given, find the most recently modified file in production/sprints/ and treat it as the current sprint.
  • If production/sprints/ does not exist or is empty:
    • At workflow: minimal there are no sprints by design — the brief's build order is the plan and the story files carry it. Report progress through it instead, then stop:
      1. The list below was printed by .claude/scripts/story-status.sh before you read this skill: one line per unfinished story, already in the route's order (IN_REVIEW, IN_PROGRESS, then TODO — a Ready or Not Started story — in build order), then BLOCKED, OTHER, NO_STATUS and the COMPLETE count:

!bash "${CLAUDE_SKILL_DIR}/../../scripts/story-status.sh"

2. Print, in under 15 lines: `Build order: [N] of [M] stories complete`
   from the `COMPLETE` line (count only `Complete` and `Done` stories —
   `In Review` is not complete), then **Next**: the story on the first
   `IN_REVIEW`, `IN_PROGRESS` or `TODO` line. The list is already
   current; do not run the script again, and do not re-rank the story files — an `In Review` story is closed before an
   `In Progress` one continues: its work is written. Recommend
   `/story-done [path]` for `IN_REVIEW`, `/dev-story [path]` for
   `IN_PROGRESS` or `TODO`. Name any `BLOCKED` story with its blocker; it is
   never Next.
3. Every story `Complete` (or `Done`) → "Build order done: [M] of [M]
   stories complete." Offer three ways on: play the build; add the next
   stories from the brief with `/create-stories`; or `/settings` to raise
   `modes.rigor` if the game has outgrown a one-page brief.
4. `STORIES none` — no story files at all → "No stories yet. Run
   `/create-stories` to turn the brief's build order into stories."
5. No `IN_REVIEW`, `IN_PROGRESS` or `TODO` line, yet the `COMPLETE` line
   is short of the total — every unfinished story is `BLOCKED`, `OTHER`
   (such as `Draft`) or `NO_STATUS`. There is **no Next**, and the build
   order is **not** done: never say it is. Print the `Build order` line,
   then name each `BLOCKED` story with its blocker — read from its story
   file, usually a `BLOCKED:` note — and each other story with its status
   as written. Recommend one step: what the first blocker needs, or else
   finishing the first `Draft` or unstatused story and setting its Status
   to `Ready`.
  • At standard or full, report: "No sprint files found. Start a sprint with /sprint-plan new." Then stop.

Read the sprint file in full. Extract:

  • Sprint number and goal
  • Start date and end date
  • All story or task entries with their priority (Must Have / Should Have / Nice to Have), owner, and estimate

2. Calculate Days Remaining

Using today's date and the sprint end date from the sprint file, calculate:

  • Total sprint days (end minus start)
  • Days elapsed
  • Days remaining
  • Percentage of time consumed

If the sprint file does not include explicit dates, note "Sprint dates not found — burndown assessment skipped."


3. Scan Story Status

First: check for production/sprint-status.yaml.

If it exists, read it directly — it is the authoritative source of truth. Extract each story's status, and its priority, owner and blocker when set — they fill the status table's columns. No markdown scanning needed. Use its sprint, goal, start, end fields instead of re-parsing the sprint plan.

If sprint-status.yaml does not exist (legacy sprint or first-time setup), fall back to markdown scanning:

  1. If the entry references a story file path, check if the file exists. Read the file and scan for status markers: DONE, COMPLETE, IN PROGRESS, BLOCKED, NOT STARTED (case-insensitive).
  2. If the entry has no file path (inline task in the sprint plan), scan the sprint plan itself for status markers next to that entry.
  3. If no status marker is found, classify as NOT STARTED.
  4. If a file is referenced but does not exist, classify as MISSING and note it.

When using the fallback, add a note at the bottom of the output: "⚠ No sprint-status.yaml found — status inferred from markdown. Run /sprint-plan update to generate one."

Optionally (fast check only — do not do a deep scan): grep the code root for a directory or file name that matches the story's system slug to check for implementation evidence. This is a hint only, not a definitive status.

Show full SKILL.md (593 more words)Show less
Stale Story Detection

After collecting status for all stories, check each IN PROGRESS story for staleness:

  • Resolve the dates with one grep across the story set, not a read per story — a date is a single line, and opening every in-progress story to find it is the whole cost of this check:
    Grep pattern="\*{0,2}(Last Updated|Updated|last-updated|updated_at)\*{0,2}[[:space:]]*:" glob="production/epics/**/story-*.md" output_mode="content"
    That one pattern accepts every field-name variant. A story with no match has no date, which is not the same as being stale — report it as "never stamped" and do not compute an age for it.

The \*{0,2} wrappers are why this works at all. /create-stories emits > **Last Updated**: …, so a pattern requiring : immediately after the word matched no story ever written. Combined with the "no match = never stamped" rule directly above — which is correct in itself — the failure was completely silent: every in-progress story reported as never stamped, and stale-story detection never once fired. A bare Updated: anchor will regress it.

  • Calculate days since that date using today's date.
  • If the date is more than 4 days ago, flag the story as STALE. (4-day threshold accounts for weekends — a story last touched on Friday won't appear stale until Wednesday.)
  • If no date field is found in the story file, note "no timestamp — cannot check staleness."
  • If the story has no referenced file (inline task), note "inline task — cannot check staleness."

STALE stories are included in the output table and collected into an "Attention Needed" section (see Phase 5 output format).

Stale story escalation: If any IN PROGRESS story is flagged STALE (no progress in 4+ days), the burndown verdict is upgraded to at least At Risk — even if the completion percentage is within the normal On Track window. Record this escalation reason: "At Risk — [S] stale story(ies): [title] ([D] days)[, …]" — [S] is how many stories are STALE, and each is named with its own [D], the days since its own Last Updated date (not the oldest age, not an average).


4. Burndown Assessment

Calculate:

  • Tasks complete (DONE or COMPLETE)
  • Tasks in progress (IN PROGRESS)
  • Tasks blocked (BLOCKED)
  • Tasks not started (NOT STARTED or MISSING)
  • Completion percentage: (complete / total) * 100

Assess burndown by comparing completion percentage to time consumed percentage:

  • On Track: completion % is within 10 points of time consumed % or ahead
  • At Risk: completion % is 10-25 points behind time consumed %
  • Behind: completion % is more than 25 points behind time consumed %

If dates are unavailable, skip the burndown assessment and report "On Track / At Risk / Behind: unknown — sprint dates not found."


5. Output

Keep the output concise. The story status table is mandatory — do not truncate it. Aim for under 50 lines total; omit the Emerging Risks section if nothing notable was found. Use this format:

markdown
## Sprint [N] Status — [Today's Date]
**Sprint Goal**: [from sprint plan]
**Days Remaining**: [N] of [total] ([% time consumed])

### Progress: [complete/total] tasks ([%])

| Story / Task         | Priority   | Status      | Owner   | Blocker        |
|----------------------|------------|-------------|---------|----------------|
| [title]              | Must Have  | DONE        | [owner] |                |
| [title]              | Must Have  | IN PROGRESS | [owner] |                |
| [title]              | Must Have  | BLOCKED     | [owner] | [brief reason] |
| [title]              | Should Have| NOT STARTED | [owner] |                |

### Attention Needed
| Story / Task         | Status      | Last Updated   | Days Stale | Note           |
|----------------------|-------------|----------------|------------|----------------|
| [title]              | IN PROGRESS | [date or N/A]  | [N days]   | [STALE / no timestamp — cannot check staleness / inline task — cannot check staleness] |

*(Omit this section entirely if no IN PROGRESS stories are stale or have timestamp concerns.)*

### Burndown: [On Track / At Risk / Behind]
[1-2 sentences. If behind: which Must Haves are at risk. If on track: confirm
and note any Should Haves the team could pull.]

### Must-Haves at Risk
[List any Must Have stories that are BLOCKED or NOT STARTED with less than
40% of sprint time remaining. If none, write "None."]

### Emerging Risks
[Any risks visible from the story scan: missing files, cascading blockers,
stories with no owner. If none, write "None identified."]

### Recommendation
[One concrete action, or "Sprint is on track — no action needed."]

6. Fast Escalation Rules

Apply these rules before outputting, and place the flag at the TOP of the output if triggered (above the status table):

Critical flag — if Must Have stories are BLOCKED or NOT STARTED and less than 40% of the sprint time remains:

SPRINT AT RISK: [N] Must Have stories are not complete with [X]% of sprint
time remaining. Recommend replanning with `/sprint-plan update`.

Completion flag — if all Must Have stories are DONE:

All Must Haves complete. Team can pull from Should Have backlog.

Missing stories flag — if any referenced story files do not exist:

NOTE: [N] story files referenced in the sprint plan are missing.
Run `/story-readiness sprint` to validate story file coverage.

Collaborative Protocol

This skill is read-only. It reports observed facts from files on disk.

  • It does not update the sprint plan
  • It does not change story status
  • It does not propose scope cuts (that is /sprint-plan update)
  • It makes at most one recommendation per run

For more detail on a specific story, the user can read the story file directly or run /story-readiness [path].

For sprint replanning, use /sprint-plan update. For end-of-sprint retrospective, use /retrospective.

© Donchitos, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/sprint-status of Donchitos/Claude-Code-Game-Studios.

Open the folder on GitHubat commit be8993b

Compare with similar skills

Sprint Status Snapshot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sprint Status Snapshot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sprint Status Snapshot this skillDonchitos/Claude-Code-Game-Studios26k—~3kAutomated safety check: PassMIT
GitHub Project Management Swarmruvnet/agentic-flow8196 repos~7.1kAutomated safety check: PassNone
Bmad Sprint Planningdelorenj/mcp-server-trello4455 repos~3kAutomated safety check: PassMIT
Scrum Masterborghei/Claude-Skills886—~2.5kAutomated safety check: PassMIT
Agile Coachborghei/Claude-Skills886—~1.2kAutomated safety check: PassMIT
Pp Linearmvanhorn/printing-press-library2.1k—~8.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Manages GitHub issues and project boards with swarm coordination: issue creation and triage, issue-to-task conversion, progress tracking and stale issue cleanup.

    819 GitHub starsUsed in 6 repos~7.1k tokens
    Product & Project ManagementAuto-check passed
  • Bmad Sprint Planning

    delorenj/mcp-server-trello

    Generate sprint status tracking from epics. An agent skill from delorenj/mcp-server-trello.

    445 GitHub starsUsed in 5 repos~3k tokens
    Product & Project ManagementAuto-check passed
  • Scrum Master

    borghei/Claude-Skills

    Data-driven Scrum Master for sprint health scoring, Monte Carlo velocity forecasting, retrospective analysis, capacity planning, and Tuckman team coaching.

    886 GitHub stars~2.5k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Agile Coach

    borghei/Claude-Skills

    Expert agile coaching: framework selection, maturity assessment, retrospective facilitation, transformation roadmaps.

    886 GitHub stars~1.2k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Pp Linear

    mvanhorn/printing-press-library

    Offline-capable, agent-native Linear CLI with SQLite-backed sync, FTS5 search, cross-cycle comparison, project...

    2.1k GitHub stars~8.8k tokensUpdated today
    Product & Project ManagementAuto-check: notes
  • Project Management Agile Coach

    chendongqi/OPB-Skills

    敏捷教练助手 - 专业的敏捷开发实践与团队效能提升专家。适用场景:(1) Sprint规划与目标设定,(2) 每日站会引导与问题跟进,(3) Sprint回顾会议总结与改进,(4) Scrum/Kanban敏捷实践指导,(5) 团队效能分析与瓶颈诊断,(6) 用户故事编写与拆分,(7) 敏捷转型咨询与落地,(8) 敏捷度量指标设计(速度/燃尽图)

    125 GitHub stars~669 tokensUpdated 8 mo ago
    Product & Project ManagementAuto-check passed

More from Donchitos/Claude-Code-Game-Studios

All 73 skills in this repo
  • Architecture Decision

    Donchitos/Claude-Code-Game-Studios

    Create an ADR documenting a technical decision: context, alternatives considered, consequences.

    26k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Dev Story

    Donchitos/Claude-Code-Game-Studios

    Implement a story: ADR guidelines, right programmer agent, code plus test.

    26k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes
  • Game Asset Audit

    Donchitos/Claude-Code-Game-Studios

    Audits game assets against naming conventions, file size budgets and format standards, and finds orphaned assets and missing references.

    26k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Game Asset Spec Writer

    Donchitos/Claude-Code-Game-Studios

    Writes per-asset visual specs and AI image-generation prompts for a game's characters, enemies and screens, driven by the GDD, art bible and an entity inventory.

    26k GitHub stars~5k tokensUpdated yesterday
    Auto-check passed
  • Game Balance Check

    Donchitos/Claude-Code-Game-Studios

    Checks game data and formulas for balance outliers, broken progression, degenerate strategies and economy problems, and answers 'could not run' when the data is missing.

    26k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Structured Bug Reports

    Donchitos/Claude-Code-Game-Studios

    Turns a description into a structured bug report, or scans code for likely bugs, then verifies and closes reports through four modes.

    26k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: notes

Questions about Sprint Status Snapshot

What does Sprint Status Snapshot do?

Gives a fast, read-only sprint snapshot with burndown and emerging risks in under 30 lines, plus at most one concrete recommendation. This is a situational-awareness check, not a sprint review. It finds the sprint file in `production/sprints/`, by number if you pass one (for example `/sprint-status 3`) or else the most recently modified file, then scans the story files for status markers and prints a concise snapshot with burndown and emerging risks.

When should I use Sprint Status Snapshot?

Sprint Status Snapshot fits situations like: getting a quick read on how the current sprint is going; spotting emerging risks mid-sprint without a full review; finding the next story to pick up in a sprintless minimal-tier project.

How do I install Sprint Status Snapshot in Claude Code?

Run `npx skills add Donchitos/Claude-Code-Game-Studios --skill sprint-status -a claude-code`. Or copy the skill folder (.claude/skills/sprint-status in Donchitos/Claude-Code-Game-Studios) into .claude/skills/sprint-status in your project. Claude Code loads it when a task matches its description.

How do I install Sprint Status Snapshot in Codex?

Run `npx skills add Donchitos/Claude-Code-Game-Studios --skill sprint-status -a codex`. Or copy the skill folder (.claude/skills/sprint-status in Donchitos/Claude-Code-Game-Studios) into .agents/skills/sprint-status in your project. Codex loads it when a task matches its description.

Can I use Sprint Status Snapshot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Donchitos/Claude-Code-Game-Studios --skill sprint-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sprint-status, .gemini/skills/sprint-status, .github/skills/sprint-status and .opencode/skills/sprint-status in your project.

What does Sprint Status Snapshot need to run?

Going by SKILL.md and its folder, Sprint Status Snapshot needs the command-line tools its instructions call (bash). Our summary lists: Sprint files in `production/sprints/` or the story-status script. Its frontmatter pre-approves these tools: Read, Glob, Grep, Bash(bash "*/.claude/skills/sprint-status/../../hooks/yaml-helper.sh" resolve_config *), Bash(bash "*/.claude/skills/sprint-status/../../scripts/story-status.sh"), Bash(bash .claude/scripts/story-status.sh*).

Does Sprint Status Snapshot access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sprint Status Snapshot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sprint Status Snapshot use?

Sprint Status Snapshot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sprint Status Snapshot use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sprint Status Snapshot?

Skills that share tags, products or a category with Sprint Status Snapshot: GitHub Project Management Swarm (ruvnet/agentic-flow, 819 stars), Bmad Sprint Planning (delorenj/mcp-server-trello, 445 stars), Scrum Master (borghei/Claude-Skills, 886 stars) and Agile Coach (borghei/Claude-Skills, 886 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sprint Status Snapshot?

Donchitos (a GitHub user) maintains it in Donchitos/Claude-Code-Game-Studios, which has 25,951 GitHub stars. The repository holds 73 skills in this directory. The repository was last updated on October 8, 2026.

Source: Donchitos/Claude-Code-Game-Studios on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.