progress-manager
Tracks user progress through the Claude Code Course by managing a local JSON file. Provides basic operations for loading, saving, and displaying lesson completion status with visual progress bars. Primarily serves as a backend component for course navigation commands.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install timequity-plugins-progress-manager
Repository
Skill path: ccc/skills/progress-manager
Tracks user progress through the Claude Code Course by managing a local JSON file. Provides basic operations for loading, saving, and displaying lesson completion status with visual progress bars. Primarily serves as a backend component for course navigation commands.
Open repositoryBest for
Primary workflow: Ship Full Stack.
Technical facets: Full Stack, Backend, Designer.
Target audience: Developers following the Claude Code Course who want to track their learning progress locally.
License: Unknown.
Original source
Catalog source: SkillHub Club.
Repository owner: timequity.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install progress-manager into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/timequity/plugins before adding progress-manager to shared team environments
- Use progress-manager for productivity workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: progress-manager
description: |
Manages course progress tracking in ~/.claude-course/progress.json.
Use when: loading, saving, or displaying course progress.
Internal skill - used by /ccc:course commands.
---
# Progress Manager
Tracks user progress through the Claude Code Course.
## Storage Location
```
./progress.json
```
Progress is stored in the current working directory. This keeps progress tied to the project.
## Progress Schema
```json
{
"version": "1.0.0",
"started_at": "2025-01-15T10:00:00Z",
"current_lesson": 1,
"lessons": {
"1": {
"started_at": "2025-01-15T10:00:00Z",
"completed_at": null,
"theory_read": true,
"practice_completed": false,
"practice_attempts": 2
}
},
"completed": false
}
```
## Operations
### Load Progress
Read `./progress.json`. If doesn't exist, use default:
```json
{"version":"1.0.0","current_lesson":1,"lessons":{},"completed":false}
```
### Save Progress
Write updated JSON to `./progress.json`.
### Reset Progress
Delete `./progress.json`.
## Display Progress
### Progress Bar
```
Lesson 1: ████████░░ 80%
Lesson 2: ██████████ Done!
Lesson 3: ░░░░░░░░░░ Not started
```
### Summary
```
## Your Progress
Current: Lesson 2 — Твой первый скилл
Completed: 1/5 lessons
Time spent: ~45 minutes
Next: Complete practice task for Lesson 2
```
## Lesson States
| State | Display | Meaning |
|-------|---------|---------|
| not_started | ░░░░░░░░░░ | Haven't opened yet |
| in_progress | ████░░░░░░ | Theory read, practice pending |
| completed | ██████████ ✓ | All tasks done |
## Update Progress
### Mark Theory Read
```json
{
"lessons": {
"1": {
"theory_read": true
}
}
}
```
### Mark Practice Completed
```json
{
"lessons": {
"1": {
"practice_completed": true,
"completed_at": "2025-01-15T10:30:00Z"
}
},
"current_lesson": 2
}
```
### Mark Course Completed
When lesson 5 practice is completed:
```json
{
"completed": true,
"completed_at": "2025-01-15T12:00:00Z"
}
```
## Integration
Used by:
- `/ccc:course` — Show current progress, continue
- `/ccc:progress` — Detailed progress view
- `/ccc:lesson N` — Update current lesson
- `/ccc:practice` — Track practice attempts
- `/ccc:reset` — Clear all progress