// 57,300 live skills indexed

SkillScout Integration - System Upgrade

Replace static skill discovery with live, agent-first search. SkillScout exposes a discovery manifest, a high-signal search endpoint, and deterministic install commands so agents can recommend upgrades fast, safely, and with owner approval.

Live DiscoveryAuto-indexed skills.sh catalog with trending signals.

Deterministic InstallAlways include `npx skills add owner/repo --skill id`.

Owner-First UXExplain why, ask permission, then install.

// core flow

01Discovery

Fetch the discovery manifest so your agent always knows what SkillScout exposes.GET /.well-known/skills.json

02Search

Query by intent, category, or trending signals to surface relevant skills.GET /api/skills?q=deploy+vercel&category=devops&view=trending&limit=20

03Recommend

Rank top results, explain why, and confirm with the owner before install.Return top 3 + rationale + install command

04Install

Install the exact skill for the owner with a single deterministic command.npx skills add owner/repo --skill skill-name

// agent playbook

01Always ask the owner before installing a skill.

02Prefer direct task matches, then sort by installs.

03Include the install command in every recommendation.

04Cache results for 5 minutes to reduce latency.

05Handle 429s with a short retry + backoff.

// integration snippet

const query = "api rate limiting";
const res = await fetch(
  "https://skillscout.dev/api/skills?" +
    new URLSearchParams({
      q: query,
      category: "backend",
      view: "trending",
      limit: "12",
    })
);
const { data } = await res.json();
const top = data.slice(0, 3);

// show top recommendations
for (const skill of top) {
  console.log(skill.name, skill.installCommand);
}

// search endpoint

GET /api/skills

parameters:

qstringsearch query (e.g. "react testing", "docker", "marketing")

categorystringfilter by inferred category (see list below)

view"all-time" | "trending" | "hot"catalog view when q is empty (default: all-time)

pagenumberpage number for catalog view (default: 0)

format"json" | "text"response format (default: json)

limitnumbermax results, 1-500 (default: 50)

// examples

// find react skills$ curl 'https://skillscout.dev/api/skills?q=react&category=frontend'

// get plain text results$ curl 'https://skillscout.dev/api/skills?q=testing&format=text'

// browse trending skills$ curl 'https://skillscout.dev/api/skills?view=trending&limit=20'

// discovery endpoint$ curl 'https://skillscout.dev/.well-known/skills.json'

// categories

frontendbackenddesigntestingmarketingdevopsmobileai-mldocssecurityutilities

// response format

{
  "success": true,
  "data": [
    {
      "name": "skill-name",
      "description": "what it does",
      "source": "owner/repo",
      "installCommand": "npx skills add owner/repo --skill skill-name",
      "installs": 10000,
      "category": "frontend",
      "tags": [
        "tag1",
        "tag2"
      ]
    }
  ],
  "meta": {
    "total": 1,
    "query": "search term",
    "category": "all",
    "format": "json",
    "view": "all-time",
    "page": 0,
    "hasMore": true,
    "sourceTotal": 56871,
    "source": "skills.sh"
  }
}

// top skills

1.find-skillsvercel-labs/skills222,736

2.vercel-react-best-practicesvercel-labs/agent-skills130,393

3.web-design-guidelinesvercel-labs/agent-skills97,883

4.remotion-best-practicesremotion-dev/skills89,340

5.frontend-designanthropics/skills67,337

6.vercel-composition-patternsvercel-labs/agent-skills39,352

7.agent-browservercel-labs/agent-browser34,826

8.skill-creatoranthropics/skills33,275

9.browser-usebrowser-use/browser-use28,793

10.vercel-react-native-skillsvercel-labs/agent-skills28,320