Check progress

Skill ishands/upstack/.agents/skills/core/check-progress

An open-source framework that configures AI as a genuine tutor — not an answer machine.

Install

npx -y skills add ishands/upstack --skill check-progress

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Display current completion state for one or all active courses. Runs collect-progress.js to parse journals and extract completion percentages with git timestamps. Use when the learner asks about their progress or at the start of a session.

SKILL.md

2.1 KB, 444 tokens by cl100k_base, as published. Nobody here has run it

Purpose

Shows the learner where they stand: which assignments are done, which remain, and when completed ones were finished. Reads directly from the journal and git history — no separate state file to maintain.

Before You Start

No files need to be pre-read. This skill runs a script and presents the output.

Procedure

Step 1 — Determine scope

Specific course requested — use --course <slug>:

node .agents/skills/core/check-progress/scripts/collect-progress.js --course <slug> --output text

All active courses — omit --course:

node .agents/skills/core/check-progress/scripts/collect-progress.js --output text

If the learner didn't specify, check the Active Course section in AGENTS-CUSTOM.md. If a course is active, scope to that course. If no course is active, run for all.

Step 2 — Run the script

Run the command from Step 1. The script walks progress/, parses each journal.md, and prints a human-readable summary.

Step 3 — Present the result

Display the output to the learner as-is.

If the output is empty (no progress/ directory or no journals found), tell the learner: "No progress found. Start a course with /start-course to begin tracking."

Notes

Script requires Node.js. If node is not available, read progress/<slug>/journal.md directly and report the Progress Tracker section manually.
Git timestamps are enriched by the script from git log. If the repo has no commits yet (e.g., fresh clone not committed), completed dates will show as null — this is expected.

Reference

Script source: .agents/skills/core/check-progress/scripts/collect-progress.js
Journal parser: scripts/utils/parse-journal.js
Git utilities: scripts/utils/git-utils.js
Tech spec §6.3.3: full skill specification