codewithmukesh/dotnet-claude-kit

checkpoint

Mid-session save point: create a descriptive git commit and a brief handoff note, then keep working.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/codewithmukesh/dotnet-claude-kit --skill checkpoint

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

/checkpoint

What

A quick mid-session save that banks the known-good state in two moves:

  1. Descriptive git commit — stage relevant changes and commit with a

message that summarizes the work.

  1. Brief handoff note — write .claude/handoff.md so a resumed session

(or you, after a botched refactor) knows exactly where things stand.

Checkpoint is the mid-session save; /wrap-up is the end-of-session ritual. Checkpoint commits and jots a note, then keeps working. Wrap-up does the full handoff plus learning extraction into MEMORY.md.

When

  • Before a risky refactor or destructive change — checkpoint the known-good state
  • When switching to a different task or feature mid-session
  • After completing a logical unit of work — bank it
  • User says "checkpoint", "save progress", "save state", "pause here"
  • If the session is actually ending, use /wrap-up for the full ritual

How

  1. Assess state — git status and git diff to see staged and unstaged

changes.

  1. Stage changes — Stage specific files; never git add -A. Exclude

generated files, build artifacts, and secrets (.env, credentials).

  1. Commit — Descriptive message following the repo's commit style

(conventional prefixes: feat:, fix:, refactor:). New commit, never amend. If there is nothing to commit, skip to the handoff.

  1. Write handoff note — .claude/handoff.md, same format as /wrap-up

but abbreviated: Completed, Pending (with specific next steps), Learned (only if something non-obvious surfaced), and Context (branch + commit hash). One file, always overwritten.

  1. Confirm — Report the commit hash and the handoff summary, then resume

work.

Safety Rules

  • Never push, force-push, or touch remote branches
  • Never commit secrets
  • Never amend — a checkpoint is a new commit you can return to
  • No changes to commit? Update the handoff only

Example

User: /checkpoint — about to try the EF Core split-query refactor

Claude: 3 files modified, 1 new.

  Commit a1b2c3d: "feat: add CreateOrder validation with FluentValidation"
  - src/Orders/Features/CreateOrder.cs
  - src/Orders/Features/CreateOrderValidator.cs (new)
  - tests/Orders.Tests/Features/CreateOrderTests.cs

  Handoff updated (.claude/handoff.md):
  ## Completed
  - [x] CreateOrder validation + 3 test scenarios
  ## Pending
  - [ ] Split-query refactor in GetOrderDetails (about to attempt)
  ## Context
  - Branch: feature/order-validation | Checkpoint: a1b2c3d

  Checkpoint saved — safe to proceed with the risky refactor.

Related

  • /wrap-up — End-of-session ritual: full handoff format definition plus

learning extraction into MEMORY.md

  • /build-fix — Get the build green before checkpointing

Related by task

from this repository

More skills

All skills
codewithmukesh
Community

clean-architecture

Clean Architecture for .NET applications. Covers the 4-project layout (Domain, Application, Infrastructure, Api), dependency inversion, use case handlers, domain entities with behavior, and infrastructure as a plugin. Load this skill when building a project with Clean Architecture, discussing layered architecture, dependency inversion, use cases, or when the architecture-advisor recommends Clean Architecture.

1h installs
3
GitHub stars
797
Updated
Aug 7
codewithmukesh
Community

arch-check

Architecture conformance check: verifies an existing codebase against its declared architecture (VSA, Clean Architecture, DDD, Modular Monolith) — dependency direction, layer violations, module boundary leaks, and cycles — using token-cheap Roslyn MCP analysis. Invoke when: "check architecture", "architecture violations", "layer violations", "dependency direction", "module boundaries", "arch check", "is my architecture clean", "enforce architecture", "conformance check". For CHOOSING an architec

1h installs
2
GitHub stars
789
Updated
Aug 7
codewithmukesh
Community

aspire

.NET Aspire for cloud-native orchestration. Covers AppHost configuration, service defaults, resource configuration, service discovery, and the Aspire dashboard. Load this skill when setting up local development orchestration, service discovery, or Aspire-managed infrastructure, or when the user mentions "Aspire", "AppHost", "service defaults", "service discovery", "orchestration", "Aspire dashboard", "AddProject", "WithReference", or "cloud-native .NET".

1h installs
2
GitHub stars
789
Updated
Aug 7
codewithmukesh
Community

build-fix

Autonomous iteration loops for .NET: drive a broken build or failing test suite to green with bounded iterations, progress detection, and fail-safe guards that prevent infinite retries and wasted tokens. The build-fix loop (dotnet build, parse, categorize, fix, rebuild) is the primary flow; the test-fix loop is a first-class variant. Invoke when the build is broken, after a major refactor or dependency update, or when the user says "fix the build", "build is broken", "make it compile", "make the

1h installs
2
GitHub stars
789
Updated
Aug 7