promote-wayfinder-script

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

SKILL.md

GitHub

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.