git-stash

SKILL.md preview

---
name: git-stash
description: >-
  Stash and restore local changes safely when you need a clean tree for other workflows. Supports push/list/show/pop/apply/drop/clear
  with explicit confirmation before destructive stash deletions. No push, no PR, no branch creation.
---

**Normative workflow:** [`read-workflow-workflows`](../../internal/read/workflow/workflows/SKILL.md#git-stash-workflow).

# Stash (save local work temporarily)

Normative fences / full matrix: [`write-stash`](../../internal/write/stash/SKILL.md), [`read-workflow-workflows`](../../internal/read/workflow/workflows/SKILL.md).

## Language interaction policy

Always apply [`read-safety-language-interaction-rules`](../../internal/read/safety/language-interaction-rules/SKILL.md) first. Use English by default for all assistant output, including AskQuestion prompts/options, unless the user explicitly requests another full-language response.

## Before batch

**Always run first** (sequential). Complete every applicable row in this table before execution steps in this skill. Skip a row only when its **When** column does not apply.

| Kind | Skill / library | When |
| --- | --- | --- |
| **Recommended** | [`@git-commit`](../commit/SKILL.md) | Prefer savepoint over stash when work should persist |
| **Recommended** | [`@git-main`](../main/SKILL.md) | Clean tree needed for align workflows |
| **Tooling** | `git` | Repo root |




## Required internal skills

Run after **Before batch** completes (names only; normative fences in linked libraries).

| Library | Role |
| --- | --- |
| `read-workflow-workflows` | See linked library |
| `write-stash` | See linked library |
| `read-safety-skill-safety` | See linked library |
| `read-safety-structured-qa` | See linked library |

## Skip & suggestions

| Flag / param | Role |
| --- | --- |
| **`skip=false`** | Root invocation — offer next-step suggestions after **Verification** |
| **`skip=true`** | Nested public-skill child call — no next-step prompt |
| **`SKIP_QA_GIT_STASH=true`** | Bypass routine write gates for this skill |
| **`SKIP_QA_WRITE=true`** | Shared write-flow Q&A bypass where allowed |
| **`SKIP_SUGGESTIONS=true`** | Suppress next-step suggestions even at root |

High-risk or destructive confirmations still require explicit user confirmation when bypass flags are set.

## Do

- Execute **[`read-workflow-workflows`](../../internal/read/workflow/workflows/SKILL.md#git-stash-workflow)** in order for stash save/inspect/restore operations.
- Use **structured confirmation** before destructive stash operations (`drop`, `clear`) per **[`read-safety-skill-safety`](../../internal/read/safety/skill-safety/SKILL.md)** and **[`read-safety-structured-qa`](../../internal/read/safety/structured-qa/SKILL.md)**.
- Prefer explicit stash labels tied to issue/branch context so later recovery is predictable.

## Do not

- Use this skill as a replacement for commits when work is ready to keep.
- Run **`@git-push`**, **`@gh-pr`**, or branch orchestration from here.
- Clear stashes without a preview of stash entries and user confirmation.

## On invoke

*`@git-stash`* — If the user intent is not explicit (`save`, `pop`, `apply`, `drop`, `clear`, or `list`), ask which stash action they want first.

## Verification

- [ ] Stash action (save/list/show/apply/pop/drop/clear) identified before fences.
- [ ] **Drop** / **clear** had preview + explicit confirmation.
- [ ] Outcome summarized (stash ref or list state).

## Recommended next steps

When **`skip=false`** (root invocation) and **`SKIP_SUGGESTIONS`** is unset, delegate to **[`read-skill-suggestions`](../../internal/read/skill-suggestions/SKILL.md)** for optional next-step choices (**summary** → **options** → AskQuestion). Nested public-skill calls use **`skip=true`**.


## Notes

- This skill complements **`@git-main`**, **`@git-pull`**, and **`@git-reset`** when the working tree must be clean.
- For long-lived or shared work, prefer a normal commit on a branch over stash storage.