Commits the most recently approved development plan to the docs/plans/ directory.

Install

mkdir -p .claude/skills/preserve && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12298" && unzip -o skill.zip -d .claude/skills/preserve && rm skill.zip

Installs to .claude/skills/preserve

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Preserve the most recently approved plan to docs/plans/
55 charsno explicit “when” trigger
Beginner

Key capabilities

  • Preserve the most recently approved plan to `docs/plans/`
  • Commit the plan locally with a `plan:` conventional commit
  • Exit plan mode before preserving the plan
  • Report the result of the preservation to the user
  • Use a POSIX bash shell for all commands

How it works

The skill takes the most recently approved plan, saves it to the `docs/plans/` directory, and then commits it locally using a `plan:` conventional commit. It requires a POSIX bash shell.

Inputs & outputs

You give it
The most recently approved plan
You get back
The plan saved as a file in `docs/plans/` and committed locally with a `plan:` conventional commit

When to use preserve

  • Documenting task implementation plans
  • Version controlling project milestones
  • Committing approved architectural designs

About this skill

Preserve the most recently approved plan to docs/plans/ and commit it. If you are in plan mode, exit plan mode first.

Run using the Bash tool (not PowerShell):

pk preserve

This commits the plan locally with a plan: conventional commit. Do not push — the user decides when to push.

Report the result to the user.

With the plan preserved, proceed with its implementation.

Rules

  • Use the Bash tool for all commands. pk requires a POSIX shell. Do not use the PowerShell tool.

When not to use it

  • When the user does not want to save the plan to `docs/plans/`
  • When the user does not want a `plan:` conventional commit
  • When the user wants to push the commit immediately

Limitations

  • Requires a POSIX bash shell
  • Commits the plan locally, does not push to remote
  • Only saves to the `docs/plans/` directory

How it compares

This skill automates the documentation and version control of approved plans with a specific commit message format, which is more structured than manually saving and committing a plan.

Compared to similar skills

preserve side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
preserve (this skill)02moReviewBeginner
tbd05moReviewIntermediate
session-handoff03moReviewBeginner
rankup-work-logging02moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry