# Checkpoint

> Create a safe checkpoint git commit on the current branch (auto-message; include agent log + safe untracked files; avoid secrets and bulky artifacts; track runs/**/{summary,report}.md only).

- Skill: `majiayu000/checkpoint-11` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/checkpoint-11`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/checkpoint-11/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/checkpoint-11

---


When invoked (or when the user says `checkpoint`), do this in order.

## 1) Preflight (must do; show output)
- `git status`
- `git diff --stat`

## 2) Sanity guardrails (must do)
- Never run: `git push`, `git commit --amend`, `git rebase`, `git reset --hard`, `git clean -fdx`, or modify git remotes.
- Never stage/commit secrets/credentials: `.env*`, `*.pem`, `*.key`, `id_rsa*`, `id_ed25519*`, tokens.
- Never stage/commit bulky artifacts: `data/**` (except `data/README.md`), `secrets/**`, most of `runs/**` (except `runs/**/summary.md` and `runs/**/report.md`), and typical artifact payloads (`*.npz`, `*.parquet`, large `*.csv`).

## 3) Ensure runs markdown is link-only (must do)
- If any `runs/**/summary.md` or `runs/**/report.md` contain embedded images (`![](...)`), fix before committing:
  - Run: `python scripts/sanitize_runs_markdown.py --root runs --write`

## 4) Stage (default: include safe untracked files)
Stage:
- `agent_logs/current.md` if modified.
- All changed files under: `src/`, `scripts/`, `configs/`, `docs/`, plus small root-level `*.md`/`*.yml`/`*.toml`.
- `runs/**/summary.md` and `runs/**/report.md` (only those).

If there are new/untracked files:
- Include them only if they are clearly source/config/docs (no artifacts) and reasonably small.
- If there are “too many” files to stage (e.g., >50 paths) or anything looks suspicious, stop and ask before staging.

Before committing, show:
- `git diff --cached --stat`

## 5) Commit (auto message; no human message required)
- Create a message `checkpoint: <short summary>` derived from the staged paths (e.g., “checkpoint: add script + tweak plots”).
- If you can’t derive a meaningful summary, use `checkpoint: wip`.
- Run `git commit -m "<message>"`.

## 6) Postflight (must do; show output)
- `git status`
- Report the commit hash.