Learn-skills.dev progress-tracker

Track and report progress across autonomous coding sessions. Use when generating progress reports, calculating metrics, visualizing completion, or estimating time to completion.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/adaptationio/skrillz/progress-tracker" ~/.claude/skills/neversight-learn-skills-dev-progress-tracker && rm -rf "$T"

manifest: data/skills-md/adaptationio/skrillz/progress-tracker/SKILL.md

source content

Progress Tracker

Tracks and reports progress across autonomous coding sessions with metrics, visualization, and completion estimation.

Quick Start

Get Progress Metrics

from scripts.progress_tracker import ProgressTracker

tracker = ProgressTracker(project_dir)
metrics = tracker.get_progress()

print(f"Features: {metrics.passing}/{metrics.total}")
print(f"Progress: {metrics.percentage:.1f}%")

Generate Report

report = tracker.generate_report(format="markdown")
print(report)

Visualize Progress

visualization = tracker.visualize_progress()
print(visualization)
# ████████████░░░░░░░░ 60% (30/50)

Progress Dashboard

┌─────────────────────────────────────────────────────────────┐
│                    PROGRESS DASHBOARD                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Overall Progress                                            │
│  ████████████████░░░░░░░░░░░░░░░░░░░░  45%                  │
│                                                              │
│  Features: 45/100 passing                                    │
│  Sessions: 12 completed                                      │
│  Commits: 87 made                                            │
│                                                              │
│  By Category                                                 │
│  ├─ auth:     ████████████████████ 100% (5/5)              │
│  ├─ crud:     ██████████████░░░░░░  70% (14/20)            │
│  ├─ ui:       ████████░░░░░░░░░░░░  40% (12/30)            │
│  ├─ api:      ██████████████████░░  90% (9/10)             │
│  ├─ testing:  ██░░░░░░░░░░░░░░░░░░  10% (2/20)             │
│  └─ other:    ██████░░░░░░░░░░░░░░  30% (3/10)             │
│                                                              │
│  Estimated Completion                                        │
│  ├─ At current rate: ~15 sessions remaining                 │
│  ├─ Time estimate: ~7.5 hours                               │
│  └─ Sessions per day: 3                                     │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Metrics Tracked

Metric	Description
Features	Passing/total feature count
Progress %	Completion percentage
Sessions	Number of sessions completed
Commits	Number of git commits
Velocity	Features per session
ETA	Estimated sessions to completion

Integration Points

context-state-tracker: Reads feature and progress data
coding-agent: Tracks feature completion
autonomous-loop: Uses metrics for continuation decisions

References

```
references/METRICS.md
```
- Detailed metrics documentation
```
references/REPORT-FORMATS.md
```
- Report format options

Scripts

```
scripts/progress_tracker.py
```
- Core ProgressTracker class
```
scripts/metrics_calculator.py
```
- Metrics calculations
```
scripts/report_generator.py
```
- Report generation
```
scripts/visualization.py
```
- ASCII visualization