# Promote

> Turn a scratch script into a permanent tool this repo keeps. Use when a check, report, or analysis has proved worth running more than once.

- Skill: `arcticfox2029/promote` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arcticfox2029/promote`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arcticfox2029/promote/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ArcticFox2029 (https://skillmd.com/u/arcticfox2029)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arcticfox2029/promote

---


# Keep a script instead of rewriting it

```
chamnan-promote <file> <name> --desc "what it checks"
chamnan-promote --list
```

## When

The plugin will tell you when the same scratch script has been written a third time. Act on that
rather than filing it away — the file is still on disk at that moment, and next session it will not
be.

Also promote without being told when a script is something the repo will want to re-run: a
regression check, a report the user asks for regularly, a migration that will be repeated per
environment.

## Write the description

`--desc` is what a future session sees when deciding whether to use the tool instead of writing a
new script. `--desc "checks the save file"` will not do that. `--desc "verifies every profile in
game/saves/ still migrates cleanly to the current GAME_VERSION"` will.

## Before promoting

Make it runnable from the repo root with no arguments, or with arguments it explains when given
none. A tool that only works from the directory it was written in gets rewritten next time anyway.