skills.rest
kmjy98-sketch
kmjy98-sketchCOMMUNITY
Explore all skills by this author →
GitHub

progress-tracker

Tracks study progress by managing part completion states in a progress.json file.

Updated Jun 15, 2026
Search Tags:#json#progress tracking#learning workflow#python cli#lecture transcripts#study management
One-click install
npx skills add https://github.com/kmjy98-sketch/khulaw --skill progress-tracker-kmjy98-sketch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: progress-tracker
Source: https://github.com/kmjy98-sketch/khulaw/tree/main/.agent/skills/progress-tracker
Command: npx skills add https://github.com/kmjy98-sketch/khulaw --skill progress-tracker-kmjy98-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It removes the need to manually remember which lecture transcript parts and study sections are finished, in progress, or next, by centralizing learning progress in a single JSON state file. ## Core Features & Use Cases - Status Overview: Displays the current textbook, page range, active transcript part, completed parts, and last session date. - Part Completion Marking: Marks transcript or lecture-note parts as complete and automatically advances the next part to in-progress. - Scope Management: Sets the current textbook, page range, and transcript file, and moves to the next part with one command. - Use Case: After finishing corrections on part03 of a civil law lecture transcript, run the completion command so part03 is marked done and part04 becomes the active part for the next study session. ## Quick Start Ask the assistant to check my current study progress and mark part01 of the transcript as complete.

Frequently Asked Questions about progress-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track study progress with a JSON file in Python?▼

Use the progress.py script with the --status flag to read progress.json and display the current textbook, page range, and part states. The --complete and --set-scope flags update the same file, keeping all progress data in one place.

How do I mark a transcript part as complete?▼

Run progress.py with --complete followed by the part name, such as part01, and optionally --type transcript or notes. The script marks that part complete and automatically sets the next unfinished part to in-progress.

Does the progress tracker require external Python packages?▼

No external packages are required. The script uses only the Python standard library modules argparse, json, sys, datetime, and pathlib, so it runs on any standard Python 3 installation.

Where is the progress data stored and can I edit it manually?▼

Progress data is stored in .agent/state/progress.json relative to the repository root. It is plain JSON with UTF-8 encoding, so you can inspect or edit it manually, and the script tolerates files saved with a UTF-8 BOM.

What happens if the progress.json file does not exist yet?▼

The script creates a default structure with empty current_scope, transcript_parts, and lecture_notes sections, plus the current date as last_session. Saving then creates the state directory and file automatically.

Related Skills

Explore More Education & Research Skills→
praxstackpraxstack
1

lecture-alchemist

Transform lecture transcripts into structured study notes with flashcards and revision plans.

Community
Advanced
Exocore-OrganizationExocore-Organization
5

flashcard-generator

Convert notes into flashcards, cloze cards, and quizzes with Anki export.

Official
Advanced
DevelopersGlobalDevelopersGlobal
65

documentation

Generate architectural decision records, code-level documentation, and operational runbooks.

Official
Advanced
SeaCloudAISeaCloudAI
1

wan2.7-image-pro

Generate high-fidelity images via SeaCloud CLI using wan27_image_pro.

Official
Advanced