Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions claude/skills/save-plan/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
name: save-plan
description: Save the current plan to ~/.claude/plans/
disable-model-invocation: true
user-invocable: true
---

# Save Plan

Save the plan from the current session to `~/.claude/plans/`, organized by repo and branch.

## Directory structure

```
~/.claude/plans/<repo-name>/<branch-name>/
YYYY-MM-DD-HHMMSS.md
```

- `<repo-name>`: basename of the git repo root (e.g. `dotfiles`)
- `<branch-name>`: current git branch or worktree branch (e.g. `add/auth-middleware`)

Example: `~/.claude/plans/dotfiles/add/auth-middleware/2026-02-14-143022.md`

## Steps

1. Detect the git repo name (`git rev-parse --show-toplevel | xargs basename`) and current branch (`git branch --show-current`).
2. Create `~/.claude/plans/<repo>/<branch>/` if it doesn't exist.
3. Write the plan as a markdown file named `YYYY-MM-DD-HHMMSS.md` (timestamp at time of save).
4. Include a YAML frontmatter block at the top with:
- `date`: full ISO 8601 timestamp
- `repo`: repo name
- `branch`: branch name
5. Then include the full plan content as markdown.
6. Confirm the file path to the user.