← All runbooks
vercel-labs / find-skills

Find Skills

This runbook enables an agent to help users discover and install skills from the open agent skills ecosystem. When a user asks "how do I do X", "find a skill for X", or expresses interest in extending agent capabilities, the agent searches the Skills CLI index and leaderboard, ve

agent claude-codemodel claude-sonnet-4-6snapshot python312-uveval programmatic10 stepsv1.0.0

Deploy Find Skills to your jetty.io

One-click installs this runbook into a collection on your Jetty account. You can run it from the Spot dashboard, schedule it, or pipe inputs in via the API.

Deploy on jetty.io →View source
The shape of the run

10 steps · start to finish.

  1. 1
    Step 1

    Environment Setup

    ▶

    Verify the environment can reach the Skills CLI and understand the user's intent.

    echo "=== ENVIRONMENT SETUP ==="

# Verify node/npx is available
command -v node >/dev/null || { echo "ERROR: node not found — install Node.js"; exit 1; }
command -v npx  >/dev/null || { echo "ERROR: npx not found — install Node.js"; exit 1; }

# Verify network access to skills.sh
curl -sf --max-time 10 https://skills.sh/ > /dev/null || echo "WARNING: skills.sh unreachable — results may be limited"

# Create output directory
mkdir -p /app/results

echo "Environment ready."

    Record the user's original request verbatim in /app/results/summary.md before proceeding.

  2. 2
    Step 2

    Understand What the User Needs

    ▶

    Analyze the user's request to identify:

  3. 3
    Step 3

    Check the Leaderboard First

    ▶

    Before running a CLI search, consult the skills.sh leaderboard to see if a well-known skill covers the domain. The leaderboard ranks skills by total installs, surfacing the most popular and battle-tested options.

  4. 4
    Step 4

    Search for Skills

    ▶

    Run the find command for each keyword phrase derived in Step 2. Capture full output.

  5. 5
    Step 5

    Verify Quality Before Recommending

    ▶

    **Do not recommend a skill based solely on search results.** For each candidate skill, verify:

  6. 6
    Step 6

    Iterate on Errors (max 3 rounds)

    ▶

    If `npx skills find` fails or returns no results:

  7. 7
    Step 7

    Present Options or Handle No-Results

    ▶

    Write the formatted recommendation to `/app/results/recommendation.md`:

  8. 8
    Step 8

    Write Executive Summary

    ▶

    Write `/app/results/summary.md` with:

  9. 9
    Step 9

    Write Validation Report

    ▶

    Write `/app/results/validation_report.json`:

  10. 10
    Step 10

    Final Checklist (MANDATORY — do not skip)

    ▶

    echo "=== FINAL OUTPUT VERIFICATION ===" RESULTS_DIR="/app/results" for f in \ "$RESULTS_DIR/summary.md" \