tk-stats
Show project task statistics and progress. Use when user says /tk:stats or asks about progress, how many tasks, completion rate, or project status.
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.
| name | tk-stats |
|---|---|
| description | Show 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
- Use the
tk_contextMCP tool to get full project state - 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