run-skill

name	run-skill
description	Execute a remote agent skill from a skills.sh or GitHub URL without installing it on the system. Use when the user invokes /run-skill <url>, shares a skills.sh link, points to a SKILL.md on GitHub, or asks to run/try/test a skill one-off without adding it to their machine.

Run Skill

Fetch a remote skill into a temporary directory, read its instructions, and execute them for the current task. Nothing is installed, registered, or persisted on the user's system.

Usage

/run-skill <ref> [task…]

• ref — one of:
  • skills.sh URL: https://www.skills.sh/<owner>/<repo>/<skill>
  • GitHub URL: repo, tree, or blob link (branch and subpath respected)
  • Shorthand: <owner>/<repo>[/<skill>]
• task — what to apply the skill to. If omitted, apply it to the current conversation context; if there is no obvious target, ask.

Steps

1. Fetch the skill into a temporary directory (use the session scratchpad when available):

   node scripts/fetch-skill.mjs <ref> --out <tmp-dir>
   

   The script resolves the ref to a GitHub repo, locates the right SKILL.md, downloads the whole skill directory, and prints JSON with skillMd (local path to the skill file), dir, files, and skipped.

2. If it fails because the repo contains multiple skills, rerun with --list and ask the user which one to run.

3. Read the downloaded SKILL.md in full. Read any files it references (references/, , examples) from as needed — they were downloaded alongside it.