AI Agent Skill HUB

promote-wayfinder-script

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

14 stars
byWayfinderFoundation
View on GitHubInstallation ↓

Best use case

promote-wayfinder-script is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using promote-wayfinder-script should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/promote-wayfinder-script/SKILL.md --create-dirs "https://raw.githubusercontent.com/WayfinderFoundation/wayfinder-paths-sdk/main/.claude/skills/promote-wayfinder-script/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/promote-wayfinder-script/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How promote-wayfinder-script Compares

Feature / Agentpromote-wayfinder-scriptStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

## 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`.

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.