tk-stats

iheanyi's avatarfrom iheanyi

Show project task statistics and progress. Use when user says /tk:stats or asks about progress, how many tasks, completion rate, or project status.

⭐18stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a comprehensive overview of project progress by generating real-time task statistics and completion metrics. It automates the tracking of task statuses, documented learnings, and active timers, enabling users to maintain project momentum and identify bottlenecks through simple natural language queries or commands.

Use Cases

  • Project Status Reporting: Instantly generate a visual breakdown of task completion (Ready, In Progress, Blocked, Done) to provide stakeholders with accurate progress updates.
  • Bottleneck Identification: Quickly identify 'Blocked' tasks and active timers to reallocate resources and resolve project stalls before they impact deadlines.
  • Knowledge Management Tracking: Monitor the volume of documented learnings and decisions to ensure the project's institutional knowledge is being captured effectively.
  • Daily Stand-up Preparation: Use the /tk:stats command to get a quick snapshot of current work-in-progress and recently completed items for team sync-ups.
nametk-stats
descriptionShow project task statistics and progress. Use when user says /tk:stats or asks about progress, how many tasks, completion rate, or project status.

Show Task Statistics

Display progress statistics for the current project.

Instructions

  1. Use the tk_context MCP tool to get full project state
  2. Calculate and display:
    • Total tasks by status (ready, in_progress, blocked, done)
    • Completion percentage
    • Number of learnings and decisions recorded
    • Any tasks with active timers

Output Format

## Project Progress

**Completion:** X/Y tasks done (Z%)

| Status      | Count |
|-------------|-------|
| Done        | X     |
| In Progress | X     |
| Ready       | X     |
| Blocked     | X     |

**Context:**
- X learnings recorded
- X decisions documented
- X tasks have notes

**Active Timers:** (if any)
- [task-id]: running for Xh Xm

Notes

  • If completion is high (>80%), congratulate progress
  • If many tasks are blocked, highlight the blockers
  • Show time spent if tasks have duration tracked