Agent skill

Checkpoint

by joshukraine in joshukraine/dotfiles

Quick 2-minute status update on current phase, completed work, blockers, and health check.

MITAuto-check passedDevelopment

Install Checkpoint

skills CLI
$ npx skills add joshukraine/dotfiles --skill checkpoint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install joshukraine/dotfiles checkpoint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/joshukraine/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/.claude/skills/checkpoint .claude/skills/checkpoint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
checkpoint
GitHub stars
429
Token cost
~600 tokens
SKILL.md length
324 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Quick 2-minute status update on current phase, completed work, blockers, and health check.

  • Works in 5 steps: Where We Are → What's In Progress → What's Next → …
  • Development work in your project
  • SKILL.md covers Context, Your Task and Tone & Approach
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Checkpoint is an agent skill from joshukraine/dotfiles. Quick 2-minute status update on current phase, completed work, blockers, and health check.

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: :roundpushpin: My dotfiles for macOS using Neovim, Zsh, and Ghostty + Tmux. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/checkpoint”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Where We Are
  2. What's In Progress
  3. What's Next
  4. Health Check
  5. Flags (if any)

What it can do on your machine

Read from SKILL.md and the folder at commit b59ad5b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Checkpoint loads about 600 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 324 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~600

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from joshukraine/dotfiles at commit b59ad5b, republished under its MIT licence (© joshukraine). 324 words, ~600 tokens.

Download SKILL.mdSave it as .claude/skills/checkpoint/SKILL.md (or your agent's skills folder).
name
checkpoint
description
Quick 2-minute status update on current phase, completed work, blockers, and health check.

Checkpoint

You are a senior developer giving your executive a quick status update. This is the hallway conversation, not the sit-down meeting. Be concise, clear, and flag anything that needs attention.

Context

Read docs/prd/ROADMAP.md, the project's CLAUDE.md, and recent git history to orient yourself. Reference specific PRD documents in docs/prd/ as needed for detail.

Your Task

Deliver a brief status checkpoint directly in the conversation. The whole thing should be scannable in under 2 minutes.


1. Where We Are
  • Current PRD phase and progress within it (e.g., "Phase 1, Step 3 of 7 — User authentication is complete, authorization is next.")
  • List recently completed work (merged PRs, closed issues) with one-line descriptions.
2. What's In Progress
  • Any open branches or uncommitted work.
  • Current issue being worked on, if applicable.
  • Blockers or decisions that need the executive's input.
3. What's Next
  • The next 2-3 items on the roadmap, drawn from the PRD.
  • Flag anything upcoming that may require a design decision, scope clarification, or the executive's attention.
4. Health Check

Run these quickly and report results:

  • Tests: Run the test suite and report pass/fail count. If failures exist, note them briefly.
  • Linting: Run the linter and report clean/issues.
  • App starts: Confirm the app boots without errors (if practical).

Report results in a compact format like:

text
Tests:   42 passed, 0 failed
Linting: clean
App:     boots OK on localhost:3000
5. Flags (if any)

Only include this section if something needs attention:

  • Technical debt accumulating in a specific area
  • A design decision that should be revisited
  • Something that worked but feels fragile
  • Dependency updates or security notices

If everything is clean, simply say "No flags."


Tone & Approach

  • Keep it tight. This is a 2-minute update, not a deep dive.
  • Use the debrief command for thorough walkthroughs — this is just orientation.
  • Be direct about problems. Don't bury bad news in qualifications.
  • If the executive should schedule a debrief based on what you're seeing, say so: "We've completed enough of Phase 1 that a debrief would be valuable before moving to Phase 2."

© joshukraine, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in claude/.claude/skills/checkpoint of joshukraine/dotfiles.

Open the folder on GitHubat commit b59ad5b

Compare with similar skills

Checkpoint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Checkpoint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Checkpoint this skilljoshukraine/dotfiles429—~600Automated safety check: PassMIT
Openspec Verify ChangeFission-AI/OpenSpec71k2 repos~4.6kAutomated safety check: PassMIT
Run Nx Generatornrwl/nx29k2 repos~592Automated safety check: NotesMIT
LoopX PR Program Managerloopx-project/loopx6.2k—~1.9kAutomated safety check: PassApache-2.0
Herdr Pre-Release Auditherdrdev/herdr43k—~289Automated safety check: PassApache-2.0
A2ui Issue Triagea2ui-project/a2ui17k—~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • Openspec Verify Change

    Fission-AI/OpenSpec

    Verify implementation matches OpenSpec change artifacts. An agent skill from Fission-AI/OpenSpec.

    71k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes
  • LoopX PR Program Manager

    loopx-project/loopx

    Tracks a group of pull or merge requests across repositories as durable LoopX state: inventory, reconcile changes, keep priorities and a roadmap, and monitor over time.

    6.2k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs. Use when asked to run or apply the repo's…

    43k GitHub stars~289 tokensUpdated today
    DevelopmentAuto-check passed
  • A2ui Issue Triage

    a2ui-project/a2ui

    Automates the triage of GitHub issues in the A2UI repository.

    17k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Happier Review

    happier-dev/happier

    Conduct evidence-backed Happier code, plan-completeness, session, worktree, feature, commit, branch, PR, codebase, and release-readiness reviews with affected-corridor analysis, high-confidence…

    1.9k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed

More from joshukraine/dotfiles

All 24 skills in this repo
  • Todoist CLI

    joshukraine/dotfiles

    Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the td CLI.

    429 GitHub starsUsed in 1 repo~6.9k tokens
    Auto-check passed
  • Autopilot Triage

    joshukraine/dotfiles

    Vet open issues for autonomous resolution and queue the qualifying ones with the autopilot-queued label — the start-of-day "fill the queue" half of the triage → run split.

    429 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Create PR

    joshukraine/dotfiles

    Create a pull request with auto-generated description, issue linking, ROADMAP updates, and PR-metadata validation.

    429 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Debrief

    joshukraine/dotfiles

    Detailed technical walkthrough covering architecture, test coverage, product tour, and key design decisions.

    429 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Drift Check

    joshukraine/dotfiles

    Pre-PR advisory check for deviations from the project spec. An agent skill from joshukraine/dotfiles.

    429 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Dustoff

    joshukraine/dotfiles

    Assess a project that's been dormant for months and produce a prioritized re-entry plan — lifecycle stage, what's stale or broken, and how far the project's tooling has drifted from current…

    429 GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check passed

Questions about Checkpoint

What does Checkpoint do?

Quick 2-minute status update on current phase, completed work, blockers, and health check. Checkpoint is an agent skill from joshukraine/dotfiles. Quick 2-minute status update on current phase, completed work, blockers, and health check.

When should I use Checkpoint?

Checkpoint fits situations like: development work in your project.

How do I install Checkpoint in Claude Code?

Run `npx skills add joshukraine/dotfiles --skill checkpoint -a claude-code`. Or copy the skill folder (claude/.claude/skills/checkpoint in joshukraine/dotfiles) into .claude/skills/checkpoint in your project. Claude Code loads it when a task matches its description.

How do I install Checkpoint in Codex?

Run `npx skills add joshukraine/dotfiles --skill checkpoint -a codex`. Or copy the skill folder (claude/.claude/skills/checkpoint in joshukraine/dotfiles) into .agents/skills/checkpoint in your project. Codex loads it when a task matches its description.

Can I use Checkpoint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add joshukraine/dotfiles --skill checkpoint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/checkpoint, .gemini/skills/checkpoint, .github/skills/checkpoint and .opencode/skills/checkpoint in your project.

What does Checkpoint need to run?

SKILL.md names no scripts, command-line tools or credentials: Checkpoint is instructions for the agent only.

Does Checkpoint access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Checkpoint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Checkpoint use?

Checkpoint is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Checkpoint use?

About 600 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Checkpoint?

Skills that share tags, products or a category with Checkpoint: Openspec Verify Change (Fission-AI/OpenSpec, 71k stars), Run Nx Generator (nrwl/nx, 29k stars), LoopX PR Program Manager (loopx-project/loopx, 6.2k stars) and Herdr Pre-Release Audit (herdrdev/herdr, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Checkpoint?

joshukraine (a GitHub user) maintains it in joshukraine/dotfiles, which has 429 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

Source: joshukraine/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.