How do I install the Check Progress skill?

Run npx skillmds@latest add ishands/check-progress in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Check Progress safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Check Progress?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Check Progress free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Check Progress?

ishands (@ishands) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Check Progress by ishands — Agent Skill

Name: Check Progress
Author: ishands

Check Progress

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.

ishands 5f526c9 3 files · 4.3 KB Updated Sep 17, 2026

File contents

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

---name: check-progressdescription: 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.---## PurposeShows the learner where they stand: which assignments are done, whichremain, and when completed ones were finished. Reads directly fromthe journal and git history — no separate state file to maintain.---## Before You StartNo files need to be pre-read. This skill runs a script and presentsthe 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 nocourse is active, run for all.### Step 2 — Run the scriptRun the command from Step 1. The script walks `progress/`, parseseach `journal.md`, and prints a human-readable summary.### Step 3 — Present the resultDisplay the output to the learner as-is.If the output is empty (no `progress/` directory or no journalsfound), 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

Frequently asked questions