promote-wayfinder-script

name	promote-wayfinder-script
description	Promote a session scratch run script into the local Wayfinder library so it persists across sessions.
metadata	{"tags":"wayfinder, runs, promotion, cleanup"}

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:

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.:

  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.