# Promote Wayfinder Script

> Promote a session scratch run script into the local Wayfinder library so it persists across sessions.

- Skill: `majiayu000/promote-wayfinder-script` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/promote-wayfinder-script`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/promote-wayfinder-script/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/promote-wayfinder-script

---


## When to use

Use this skill when a one-off script created during an interactive session is worth keeping for future reuse.

## How to use

This repo creates a per-session scratch directory (see `$WAYFINDER_SCRATCH_DIR`) and a persistent local library (see `$WAYFINDER_LIBRARY_DIR`).

Keep (promote) a script when it worked as intended and you expect it to be useful again in later sessions — the goal is to speed up future runs by reusing a known-good script instead of regenerating/re-reviewing new ad-hoc code.

Promote a script into the library:

```bash
poetry run python scripts/promote_wayfinder_script.py "$WAYFINDER_SCRATCH_DIR/my_script.py" my_script
```

Notes:
- By default, scripts are organized under `$WAYFINDER_LIBRARY_DIR/<protocol>/...` when the tool can infer a protocol from the filename/content (otherwise it uses `misc/`).
- You can force the folder with `--protocol`, e.g.:

  ```bash
  poetry run python scripts/promote_wayfinder_script.py "$WAYFINDER_SCRATCH_DIR/my_script.py" my_script --protocol hyperliquid
  ```
- The destination is `$WAYFINDER_LIBRARY_DIR/<protocol>/<name>.py`.
- The promoted copy gets a short header block (source + timestamp + optional description).
- A simple index is maintained at `$WAYFINDER_LIBRARY_DIR/index.json`.