Skillsmp Search

curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=YOUR_QUERY" \
     -H "Authorization: Bearer $SKILLSMP_API_KEY"

Example queries:

• "SvelteKit components and routing"
• "Hono backend API patterns"
• "Vitest testing patterns"

Keyword Search

For exact skill names or specific terms:

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=KEYWORD&limit=10&sortBy=stars" \
     -H "Authorization: Bearer $SKILLSMP_API_KEY"

Parameters:

• q (required): Search query
• limit: Results per page (default: 20, max: 100)
• sortBy: "stars" or "recent"
• page: Page number for pagination

Response Structure

{
  "success": true,
  "data": {
    "data": [
      {
        "skill": {
          "id": "skill-slug",
          "name": "Skill Name",
          "author": "github-username",
          "description": "What the skill does",
          "githubUrl": "https://github.com/...",
          "skillUrl": "https://skillsmp.com/skills/...",
          "stars": 42
        },
        "score": 0.85
      }
    ]
  }
}

Installing a Skill

1. Get the githubUrl from the search result
2. Convert to raw GitHub URL for the SKILL.md file
3. Download to .agent/skills/<skill-name>/SKILL.md

Example:

# From: https://github.com/author/repo/tree/main/.claude/skills/my-skill
# Download:
curl -sL "https://raw.githubusercontent.com/author/repo/main/.claude/skills/my-skill/SKILL.md" \
     -o .agent/skills/my-skill/SKILL.md

4. Update the skill-index: Add the new skill to .agent/skills/skill-index/SKILL.md

Search Strategy

1. Start with AI search for broad capability needs
2. Use keyword search when you know specific tool/library names
3. Sort by stars to find popular, well-maintained skills
4. Check the score (higher = better semantic match)

Common Search Patterns