home / skills / openclaw / skills / stash-name-gen

stash-name-gen skill

safe

This skill reads your changes and generates a meaningful git stash name, then stashes with that name to keep work organized.

npx playbooks add skill openclaw/skills --skill stash-name-gen

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.9 KB

---
name: stash-namer
description: Generate meaningful git stash names from your changes. Use when stashing work.
---

# Stash Namer

Stop naming stashes "WIP" or leaving them unnamed. This reads your changes and creates a meaningful stash name.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-stash-name
```

## What It Does

- Reads your staged and unstaged changes
- Generates a descriptive stash name
- Actually runs git stash with the name
- No more mystery stashes

## Usage Examples

```bash
# Stash with auto-generated name
npx ai-stash-name

# Preview without stashing
npx ai-stash-name --dry-run
```

## Best Practices

- **Stash early, stash often** - it's free
- **Name them well** - future you will thank you
- **Don't hoard stashes** - apply or drop them
- **Pop, don't apply** - unless you need to keep it

## When to Use This

- Switching contexts quickly
- Saving work before pulling
- Experimenting with changes
- Any time you'd use git stash

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-stash-name --help
```

## How It Works

Runs git diff to see your changes, sends the diff summary to GPT-4o-mini to generate a descriptive name, then runs git stash push -m with that name.

## License

MIT. Free forever. Use it however you want.

---

**Built by LXGIC Studios**

- GitHub: [github.com/lxgicstudios/stash-name-gen](https://github.com/lxgicstudios/stash-name-gen)
- Twitter: [@lxgicstudios](https://x.com/lxgicstudios)

Overview

This skill generates meaningful git stash names from the actual changes in your working tree so you stop using vague labels like "WIP". It inspects staged and unstaged diffs, queries a language model to produce a concise description, and then runs git stash with that message. One command, no configuration needed.

How this skill works

The tool runs git diff (and staged diffs) to collect a summary of changed files and hunks, sends that summary to a small GPT model to create a human-readable stash name, and then executes git stash push -m with the generated message. It also supports a dry-run mode to preview the name without creating the stash.

When to use it

Before switching branches to capture current work with a clear label
Prior to pulling or merging to save in-progress changes
When experimenting or prototyping so your stashes are searchable later
Any time you would normally run git stash and want a descriptive message
When cleaning your working tree but planning to resume work soon

Best practices

Run the command frequently—short, descriptive stashes are easy to revisit
Use --dry-run to preview and confirm long or ambiguous names
Keep stashes short and actionable; include the intent or affected component
Avoid hoarding stashes—apply or drop them once work is resumed or merged
Ensure your OPENAI_API_KEY is set if using the hosted model integration

Example use cases

Stash changes that fix a bug in the auth flow before switching to a hotfix branch
Save experimental UI tweaks with a name like "refactor: sidebar state + fix layout"
Capture partial feature work before pulling upstream changes
Store quick prototype work so you can iterate without losing context
Create readable stash messages across a team to speed retrieval

FAQ

Do I need to configure anything to use it?

No configuration is required for basic use; run with npx. For model-backed name generation, set OPENAI_API_KEY in your environment.

Can I preview the generated stash name without creating the stash?

Yes. Use the --dry-run flag to see the suggested name without running git stash.