Agent skill

Cs Checkpoint Version

by ChenShuo2004 in ChenShuo2004/cs-skills

A skill your agent uses when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky…

MITAuto-check passedDevOps & Cloud

Install Cs Checkpoint Version

skills CLI
$ npx skills add ChenShuo2004/cs-skills --skill cs-checkpoint-version -a claude-code

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

GitHub CLI
$ gh skill install ChenShuo2004/cs-skills cs-checkpoint-version --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/ChenShuo2004/cs-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cs-checkpoint-version .claude/skills/cs-checkpoint-version && 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
cs-checkpoint-version
GitHub stars
193
Token cost
~1.1k tokens
SKILL.md length
426 words
Files
5 (incl. scripts)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky…

  • Works in 4 steps: Inspect the repository → Pick a short slug from the task, such as… → Run the bundled script from this skill → …
  • The user asks to save the current repository version
  • SKILL.md covers Purpose, Rules, Save Workflow and Restore Workflow, plus 3 more sections
  • Runs PowerShell scripts from its folder; calls git

What it does

Cs Checkpoint Version is an agent skill from ChenShuo2004/cs-skills. Use when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky edits, or restore a prior checkpoint. Trigger for "$cs-checkpoint-version", "保存当前版本", "方便回退", "回退点", "checkpoint", "rollback", "restore checkpoint", or similar wording.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `agents/openai.yaml`).

It sits in DevOps & Cloud, covering Git worktrees. It works with Git. The repository describes itself as: 陈硕的 Codex Skills 与 AI 工作流手册:把产品、内容、调研与交付沉淀为可复用的智能工作流。 The licence is MIT.

When your agent uses it

  • The user asks to save the current repository version
  • Create a rollback point
  • Checkpoint dirty worktree changes
  • Preserve staged/unstaged/untracked files before risky edits

Example prompts

  • “$cs-checkpoint-version”
  • “保存当前版本”
  • “checkpoint”
  • “/cs-checkpoint-version”

Requirements

  • PowerShell

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the repository
  2. Pick a short slug from the task, such as before-refactor, before-release, or current-version.
  3. Run the bundled script from this skill
  4. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 6f5009d. 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

    Ships 2 files in scripts/ (PowerShell), which the agent can run.

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Cs Checkpoint Version loads about 1.1k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 426 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ChenShuo2004/cs-skills at commit 6f5009d, republished under its MIT licence (© ChenShuo2004). 426 words, ~1,129 tokens.

Download SKILL.mdSave it as .claude/skills/cs-checkpoint-version/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
cs-checkpoint-version
description
Use when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky edits, or restore a prior checkpoint. Trigger for "$cs-checkpoint-version", "保存当前版本", "方便回退", "回退点", "checkpoint", "rollback", "restore checkpoint", or similar wording.
<!-- CS Skills · 陈硕 | portable skill entry | https://github.com/ChenShuo2004/cs-skills -->

Checkpoint Version

Purpose

Use this skill to create a local, file-based rollback point for one Git repository.

The default goal is safety: preserve the current branch, HEAD, staged diff, unstaged diff, and untracked files without creating a commit or changing the branch.

Rules

  • Work in one Git repository root. Confirm with git rev-parse --show-toplevel.
  • Create a checkpoint when requested or when this change needs a rollback artifact; do not snapshot every routine edit. Reuse a verified checkpoint only if HEAD, staged/unstaged diffs and untracked inputs have not changed.
  • Default to a safe snapshot under .codex-checkpoints/; do not commit unless the user explicitly asks for a Git checkpoint commit.
  • Include staged, unstaged, and untracked non-ignored files. Do not include ignored files such as dependencies, builds, caches, or secrets.
  • Never restore a checkpoint unless the user explicitly asks to roll back or restore.
  • Before restore, preserve the current worktree with a pre-restore checkpoint.

Save Workflow

  1. Inspect the repository:
powershell
git rev-parse --show-toplevel
git status --short --branch
  1. Pick a short slug from the task, such as before-refactor, before-release, or current-version.

  2. Run the bundled script from this skill:

powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\create-checkpoint.ps1" -Repo "<repo-root>" -Slug "current-version"
  1. Report:
  • checkpoint directory
  • branch and HEAD
  • whether staged, unstaged, and untracked files were captured
  • restore command

Restore Workflow

Use this only after the user explicitly asks to restore a checkpoint.

  1. Inspect available checkpoints:
powershell
Get-ChildItem -Directory "<repo-root>\.codex-checkpoints" | Sort-Object Name -Descending
  1. Read the checkpoint metadata:
powershell
Get-Content "<checkpoint-path>\metadata.json" -Raw
  1. Restore with the bundled script. The restore request supplies authorization; do not ask again for the same checkpoint. Still preserve pre-restore state and respect the separate CleanUntracked boundary:
powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\restore-checkpoint.ps1" -Repo "<repo-root>" -Checkpoint "<checkpoint-path>" -Force

Add -CleanUntracked only when the user wants an exact rollback that removes untracked files created after the checkpoint. The restore script excludes .codex-checkpoints/ from git clean.

  1. Verify after restore:
powershell
git status --short --branch
git diff --cached --stat
git diff --stat
Show full SKILL.md (148 more words)Show less

Script Outputs

scripts/create-checkpoint.ps1 writes:

  • metadata.json: branch, HEAD, timestamp, counts, and restore hint
  • status.txt: branch-aware short status
  • status-porcelain.txt: exact status entries with untracked files expanded
  • staged.patch: binary-safe staged diff
  • unstaged.patch: binary-safe unstaged diff
  • untracked-files.txt: untracked non-ignored file list
  • untracked.zip: untracked file archive when untracked files exist

scripts/restore-checkpoint.ps1 resets to the checkpoint HEAD, reapplies staged and unstaged patches, restores untracked files, and creates a pre-restore checkpoint when the current worktree is not clean.

Common Mistakes

MistakeCorrect behavior
Treating checkpoint as a commitUse file snapshots by default; commit only when requested.
Saving only git diffAlso capture staged diff and untracked files.
Restoring without preserving current stateLet the restore script create pre-restore first.
Including ignored outputsKeep dependencies, build folders, caches, logs, and secrets out.
Running restore for a vague requestAsk which checkpoint to restore before changing files.

Verification

Run the bundled tests after editing the scripts:

powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\tests\cs-checkpoint-version.tests.ps1"

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

Files

SKILL.md and 4 other files (scripts) in cs-checkpoint-version of ChenShuo2004/cs-skills.

  • SKILL.md
  • agents/openai.yaml
  • scripts/create-checkpoint.ps1
  • scripts/restore-checkpoint.ps1
  • tests/cs-checkpoint-version.tests.ps1

Open the folder on GitHubat commit 6f5009d

Compare with similar skills

Cs Checkpoint Version 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.

Cs Checkpoint Version compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cs Checkpoint Version this skillChenShuo2004/cs-skills193—~1.1kAutomated safety check: PassMIT
Update NanoClaw Safelynanocoai/nanoclaw31k—~2.9kAutomated safety check: NotesMIT
Checkopenwpm/OpenWPM1.4k—~1.5kAutomated safety check: PassCustom licence
Cap Feature Building WorkflowCapSoftware/Cap23k—~2.5kAutomated safety check: WarnCustom licence
Build Px4 macOSPX4/PX4-Autopilot13k—~1.1kAutomated safety check: PassBSD-3-Clause
Burla Parallel Dev ClustersBurla-Cloud/burla263—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Update NanoClaw Safely

    nanocoai/nanoclaw

    Updates a customized NanoClaw install from the official upstream in a staged worktree, with state snapshots, migration gates, health checks and automatic rollback.

    31k GitHub stars~2.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Check

    openwpm/OpenWPM

    A skill your agent uses to check on background feature agents launched via /kickoff — running in tmux sessions or docker/podman containers.

    1.4k GitHub stars~1.5k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Builds a Cap feature in an isolated Git worktree with disposable dev resources, verification, a recorded demo and a neutral pull request, started with /building.

    23k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: warnings
  • Build Px4 macOS

    PX4/PX4-Autopilot

    Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.

    13k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Sets up an isolated Burla dev cluster per git worktree so several agents can work in parallel, and explains when to use local-dev or remote-dev.

    263 GitHub stars~1.6k tokensUpdated 16 days ago
    DevelopmentAuto-check passed
  • Devcontainer Dev

    stacklok/toolhive-studio

    Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).

    170 GitHub stars~3.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from ChenShuo2004/cs-skills

All 26 skills in this repo
  • Cs Code Video

    ChenShuo2004/cs-skills

    用代码做动画视频:页面暴露 render(t),Playwright 逐帧截图 + FFmpeg 合成 mp4,可接合成配乐、出图和配音。通用模式先明确主题、规格、风格和声音,出风格卡、分镜与关键帧后逐镜制作;Vibe知识大赏模式额外查证来源、记录真实素材许可、先渲 10 秒样片。触发词包括…

    193 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Cs Knowledge Film

    ChenShuo2004/cs-skills

    制作明确要求暗夜星空、衬线双语字幕与金色光点风格的知识解说片,或用户显式调用 $cs-knowledge-film:从概念与画面隐喻设计,到口播、场景 spec、配音和 1080p 渲染。普通科普视频不默认套用这一视觉模板;网页产品演示、ChatCut 策划和电商视频复刻各用对应 skill。

    193 GitHub stars~806 tokensUpdated today
    Auto-check passed
  • Cs Auto Videl

    ChenShuo2004/cs-skills

    A skill your agent uses when the user types $cs-auto-videl or asks for Douyin/TikTok ecommerce video workflows, including competitor replication, strong-Hook nine-grid promptimage.md to image2…

    193 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 当用户要把产品事实、口播、数字人、产品界面和 CTA 制作成可验收的数字人产品介绍视频时使用:统一预检 ChatCut、FFmpeg、ComfyUI、Fish/TTS 与 Remotion,按 plan、sample、batch 三种模式编排,先完成可审批样片再批量或出成片。用于有明确产品包的横版/竖版产品视频流水线;不要用于通用自动剪辑、电商短视频复刻、纯视频选题策划或未经确认的批量生成与发布。

    193 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Cs Code Story Video

    ChenShuo2004/cs-skills

    把中文口播、角色和参考素材制作成可验收的 16:9 代码叙事视频:A-roll 角色讲述、全屏场景 B-roll、真实音频时码、Remotion 样片与成片、3:4/4:3 杂志风封面。仅用于代码驱动的叙事视频,不替代 ChatCut 剪辑、数字人产品片或电商复刻。

    193 GitHub stars~541 tokensUpdated today
    Auto-check passed
  • Cs Codex Image

    ChenShuo2004/cs-skills

    通过 Codex 内置生图生成或编辑图片,并将该能力接入 Claude Code、Claude 桌面版或其他本地 MCP Agent。用于 cs-codex-image、内置生图、不用 API Key 出图、Claude 调用 Codex 生图。固定 KAI 封面和小黄角色仍由对应品牌 Skill 决定视觉规范。

    193 GitHub stars~415 tokensUpdated today
    Auto-check passed

Works with

Questions about Cs Checkpoint Version

What does Cs Checkpoint Version do?

A skill your agent uses when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky…. Cs Checkpoint Version is an agent skill from ChenShuo2004/cs-skills. Use when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky edits, or restore a prior checkpoint.

When should I use Cs Checkpoint Version?

Cs Checkpoint Version fits situations like: the user asks to save the current repository version; create a rollback point; checkpoint dirty worktree changes; preserve staged/unstaged/untracked files before risky edits.

How do I install Cs Checkpoint Version in Claude Code?

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

How do I install Cs Checkpoint Version in Codex?

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

Can I use Cs Checkpoint Version 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 ChenShuo2004/cs-skills --skill cs-checkpoint-version -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cs-checkpoint-version, .gemini/skills/cs-checkpoint-version, .github/skills/cs-checkpoint-version and .opencode/skills/cs-checkpoint-version in your project.

What does Cs Checkpoint Version need to run?

Going by SKILL.md and its folder, Cs Checkpoint Version needs PowerShell for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: PowerShell.

Does Cs Checkpoint Version access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cs Checkpoint Version 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cs Checkpoint Version use?

Cs Checkpoint Version 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 Cs Checkpoint Version use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Cs Checkpoint Version?

Skills that share tags, products or a category with Cs Checkpoint Version: Update NanoClaw Safely (nanocoai/nanoclaw, 31k stars), Check (openwpm/OpenWPM, 1.4k stars), Cap Feature Building Workflow (CapSoftware/Cap, 23k stars) and Build Px4 macOS (PX4/PX4-Autopilot, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cs Checkpoint Version?

ChenShuo2004 (a GitHub user) maintains it in ChenShuo2004/cs-skills, which has 193 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

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