Tracks session progress and efficiency using breadcrumbs and takt time metrics.

Install

mkdir -p .claude/skills/session-status && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/5691" && unzip -o skill.zip -d .claude/skills/session-status && rm skill.zip

Installs to .claude/skills/session-status

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Generate breadcrumb headers/footers with takt time tracking and muda metrics
76 charsno explicit “when” trigger
Beginner

Key capabilities

  • Collect current session state data including feature name and phase
  • Calculate takt time by comparing duration against predefined targets
  • Format a single-line breadcrumb header with status, feature, and progress
  • Generate a context-specific footer with dynamic action prompts
  • Track silent metrics like loop count, waiting time, and rework
  • Integrate with Ask, Agent, and Plan modes for automatic invocation

How it works

This skill generates persistent status headers and footers by gathering session state, calculating takt time against targets, and formatting the information.

Inputs & outputs

You give it
Current session state, phase, loop count, progress, and duration
You get back
A formatted header string, a context-specific footer string, and updated silent metrics

When to use session-status

  • Track session duration during active coding
  • Visualize phase progress in long tasks
  • Monitor workflow efficiency
  • Standardize session status reporting

About this skill

Session Status Skill

Generate consistent navigation breadcrumbs showing current position, takt time, and session metrics.

When to Use

  • At START of every Ask/Agent/Plan mode response
  • At END of every Ask/Agent/Plan mode response
  • When session metrics are needed for Session Journal sync

Phase 1: Gather State

Collect current session state:

DataSource
Feature nameFrom init context or branch name
Current phaseDIVERGE / CONVERGE / DEFINE / AGENT
Loop countIncremented on each user feedback cycle
ProgressValidated items / total items
DurationTime since phase started
StatusG (flow) / Y (waiting) / R (stopped)

Phase 2: Calculate Takt

Compare duration against targets from 03-shared.mdc:

PhaseTargetWarningStop
DIVERGE (per loop)15min30min60min
CONVERGE20min40min90min
DEFINE10min20min45min
Commit (each)10min20min30min

Determine suffix:

  • Under target: (none)
  • Warning exceeded: !
  • Stop exceeded: !!

Phase 3: Format Header

Generate single-line breadcrumb:

Format: [STATUS] | [Feature] | [PHASE_PROGRESS] | L[N] | [X]/[Y] | [TIME]

Examples by phase:

  • DIVERGE: G | Collaboration | DIVERGE ###....... | L3 | 5/9 | 18m
  • CONVERGE: G | Collaboration | DIVERGE OK | CONVERGE ##.... | L1 | 22m
  • DEFINE: G | Collaboration | DIVERGE OK | CONVERGE OK | DEFINE ###.. | L2 | 35m
  • AGENT: G | Collaboration | AGENT | C2/5 | 45m
  • Warning: Y | Collaboration | DIVERGE ###....... | L3 | 5/9 | 32m!
  • Stopped: R | Collaboration | AGENT | JIDOKA STOP

Progress bar: 10 chars, # filled, . empty, proportional to completion.

Phase 4: Format Footer

Generate context-specific footer:

---
Next: [action prompt]

Dynamic prompts by context:

ContextFooter Prompt
DIVERGE with DIGProvide OK/KO/DIG for: #4, #6, #7
Gate 1 passedAll validated. Say "converge" to proceed.
Gate 2Choose option: A / B / C
Gate 3Approve phasing: OK / REORDER / SPLIT
AGENTCommit 2/5 in progress...
Jidoka stopReply with A, B, C, or D
AutonomousIteration 3/5...

Phase 5: Track Muda (Silent)

Update session metrics in memory:

MetricTracking Rule
Loop countIncrement on user feedback
Waiting timeTime between user responses
ReworkItems DIG'd 3+ times
RED countqa-commit failures
EscalationsJidoka Tier 2/3 events

Output Format

## Session Status

**Header:** [formatted header string]
**Footer:** [formatted footer string]

### Metrics (Silent)
- Duration: [N]min
- Loops: [N]
- Rework: [N]
- Waiting: [N]min
- RED count: [N]

Header/Footer Examples

Ask Mode - DIVERGE L3

Header:

G | Collaboration | DIVERGE ###....... | L3 | 5/9 | 18m

Footer:

---
Next: Provide OK/KO/DIG for: #4, #6, #7

Ask Mode - Gate 1 Passed

Header:

G | Collaboration | DIVERGE OK | CONVERGE #......... | L1 | 22m

Footer:

---
Next: All wireframes validated. Say "converge" to proceed.

Agent Mode - Commit in Progress

Header:

G | Collaboration | AGENT | C2/5 | 45m

Footer:

---
Next: Implementing Commit 2: Add workspace membership entity...

Jidoka Stop

Header:

R | Collaboration | AGENT | JIDOKA STOP

Footer:

---
Next: Reply with A (different approach), B (skip), C (pause), or D (abort)

Integration

This skill is invoked by:

  • ask.mdc - At start and end of every response
  • agent.mdc - At start and end of every response
  • plan.mdc - At start and end of every response
  • push-pr.mdc - Collects final metrics for session-journal sync

Invocation

Auto-invoked by modes. Manual trigger: "show session status"

Tools Used

ToolPurpose
(none)Pure calculation, no external tools

How it compares

This skill provides real-time, standardized session status with takt time and dynamic prompts, offering more structured and actionable feedback than manual status updates.

Compared to similar skills

session-status side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
session-status (this skill)17moReviewBeginner
it-operations17moNo flagsAdvanced
customerio-cost-tuning025dReviewIntermediate
perplexity-incident-runbook025dReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry