claude-skills

claude-skills

Personal collection of Claude Code skills.

Skills

Skill	What it does
handoff-push	Park current working state + session context on a handoff/<topic> git branch so work can be picked up on another machine or in a fresh session.
handoff-pull	Pick up work parked by handoff-push — fetches the branch, reads .handoff/notes.md, and briefs you on current state + next action.

Together the two skills turn a git branch into the handoff medium: no tarballs, no env-var smuggling, no auth secrets crossing machines. The code + .handoff/notes.md live in your repo's remote; anything else (dotfiles, env, memory) is handled separately by you.

Install

Add the marketplace, then install the plugin:

/plugin marketplace add canyugs/claude-skills
/plugin install claude-skills@canyugs

Once installed, the skills show up as claude-skills:handoff-push and claude-skills:handoff-pull in your Claude Code session. They also trigger on natural-language requests like "handoff this session" or "pick up the handoff".

Local development / testing

claude --plugin-dir /path/to/claude-skills

Usage

# On the source machine, mid-task:
> handoff this session

# Claude creates handoff/<topic> branch, writes .handoff/notes.md,
# commits, pushes, and prints pickup instructions.

# On the other machine (or in a new session):
$ git fetch && git checkout handoff/<topic>
$ claude
> pick up the handoff

# Claude reads .handoff/notes.md and briefs you on current state.

For the full walkthrough (invocation phrases, .handoff/notes.md schema, lifecycle, tips), see docs/usage.md.

Testing

See docs/testing.md for install verification, smoke-test recipes, and the end-to-end validation checklist.

What handoff does NOT do

• Does not touch env vars, auth tokens, kubeconfig, or memory directories. Those live outside git; manage them separately (dotfiles / 1Password CLI / machine-local re-auth).
• Does not open a PR for the handoff branch — it's a scratch branch, not a feature branch.
• Does not rebase or merge. Handoff branches are disposable; delete when the topic is done.

License

MIT