API Documentation

curl https://skills.findutils.com/api/skills

# Filter by tool
curl https://skills.findutils.com/api/skills?tool=cursor

# Search
curl https://skills.findutils.com/api/skills?q=react

# Get a single skill
curl https://skills.findutils.com/api/skills/react-typescript-best-practices

const res = await fetch('https://skills.findutils.com/api/skills?tool=claude-code&quality=featured');
const { data, meta } = await res.json();
console.log(`${meta.total} skills found`);
data.forEach(s => console.log(s.title, s.category));

https://skills.findutils.com

{
  "success": false,
  "error": "Skill not found."
}

GET /api/skills

{
  "success": true,
  "data": [
    {
      "slug": "react-typescript-best-practices",
      "title": "React + TypeScript Best Practices",
      "description": "Modern React 19 patterns with TypeScript strict mode, Server...",
      "content": "You are an expert in...",
      "tools": ["claude-code","cursor","copilot"],
      "category": "web-development",
      "tags": ["react","typescript","react-19","server-components"],
      "quality": "featured",
      "author": "FindUtils",
      "updatedAt": "2026-04-05"
    }
  ],
  "meta": {
    "total": 192,
    "limit": 100,
    "offset": 0
  }
}

# Featured React skills for Claude Code, page 2
GET /api/skills?tool=claude-code&category=web-development&quality=featured&limit=10&offset=10

GET /api/skills/:slug

GET /api/skills/react-typescript-best-practices

// Response:
{
  "success": true,
  "data": {
    "slug": "react-typescript-best-practices",
    "title": "React + TypeScript Best Practices",
    "content": "You are an expert in...",
    ...
  }
}

# Search for "react hooks"
GET /api/skills?q=react+hooks

# Combine with tool filter
GET /api/skills?q=typescript&tool=cursor

GET /api/categories

{
  "success": true,
  "data": [
    { "slug": "web-development", "label": "Web Development", "icon": "🌐", "description": "React, Next.js, Vue, Svelte, Astro, Tail...", "skillCount": 30 },
    { "slug": "backend", "label": "Backend", "icon": "⚙️", "description": "Node.js, Python, Go, Rust, Ruby, PHP, Ja...", "skillCount": 20 },
    { "slug": "mobile", "label": "Mobile", "icon": "📱", "description": "React Native, Flutter, Swift, Kotlin, an...", "skillCount": 10 }
    ...
  ]
}

GET /api/tools

{
  "success": true,
  "data": [
    { "slug": "claude-code", "label": "Claude Code", "filename": "CLAUDE.md", "filepath": "CLAUDE.md (project root)", "docsUrl": "...", "color": "#d97706", "skillCount": 192 },
    { "slug": "cursor", "label": "Cursor", "filename": ".mdc", "filepath": ".cursor/rules/{name}.mdc", "docsUrl": "...", "color": "#3b82f6", "skillCount": 192 },
    { "slug": "copilot", "label": "GitHub Copilot", "filename": "copilot-instructions.md", "filepath": ".github/copilot-instructions.md", "docsUrl": "...", "color": "#22c55e", "skillCount": 192 }
    ...
  ]
}

# Browse all collections
GET /collections

# View a specific collection
GET /collections/full-stack-react

GET /api/compose?stack=slug1,slug2,...&tool=claude-code

{
  "success": true,
  "data": {
    "skills": [
      { "slug": "react-typescript-best-practices", "title": "React + TypeScript Best Practices" },
      { "slug": "nextjs-app-router", "title": "Next.js 15 App Router Patterns" }
    ],
    "content": "# Stack: React + TypeScript Best Practices + ...\n\n## React + TypeScript...\n\n...",
    "conflicts": [],
    "shareUrl": "https://skills.findutils.com/compose?stack=react-typescript-best-practices,nextjs-app-router"
  }
}

GET /marketplace.json

{
  "name": "findutils-skills",
  "description": "Curated AI coding skills directory...",
  "version": "1.0.0",
  "homepage": "https://skills.findutils.com",
  "skills": [
    {
      "id": "react-typescript-best-practices",
      "name": "React + TypeScript Best Practices",
      "version": "1.0.0",
      "category": "web-development",
      "tags": ["react", "typescript"],
      "quality": "featured",
      "tools": ["claude-code", "cursor", ...],
      "install": "https://skills.findutils.com/api/skills/react-typescript-best-practices"
    }
  ],
  "categories": [...],
  "totalSkills": 192
}

/skills/{slug}/{tool}

# Examples:
/skills/react-typescript-best-practices/claude-code
/skills/react-typescript-best-practices/cursor
/skills/react-typescript-best-practices/copilot
/skills/react-typescript-best-practices/windsurf
/skills/react-typescript-best-practices/cline
/skills/react-typescript-best-practices/aider
/skills/react-typescript-best-practices/codex
/skills/react-typescript-best-practices/gemini-cli

POST /api/submit
Content-Type: application/json

{
  "title": "My Custom Skill",
  "description": "One-line description of what this skill does",
  "content": "You are an expert in...\n\nKey Principles:\n- Rule one\n- Rule two",
  "category": "web-development",
  "tools": ["claude-code", "cursor"],
  "tags": ["react", "typescript"],
  "author": "Your Name",
  "sourceUrl": "https://github.com/..."
}

{
  "success": true,
  "message": "Skill submitted for review."
}

// Fetch all featured React skills
const res = await fetch('https://skills.findutils.com/api/skills?tool=claude-code&quality=featured&category=web-development');
const { data } = await res.json();

// Display each skill
for (const skill of data) {
  console.log(`${skill.title} (${skill.quality})`);
  console.log(`  Tags: ${skill.tags.join(', ')}`);
  console.log(`  Tools: ${skill.tools.join(', ')}`);
  console.log();
}

// Compose a stack
const stack = 'react-typescript-best-practices,nextjs-app-router,tailwind-css-patterns';
const compose = await fetch(`https://skills.findutils.com/api/compose?stack=${stack}&tool=cursor`);
const { data: composed } = await compose.json();
console.log(composed.content);

import requests

# List all skills for a tool
resp = requests.get("https://skills.findutils.com/api/skills", params={
    "tool": "claude-code",
    "quality": "featured",
    "limit": 20,
})
skills = resp.json()["data"]

for skill in skills:
    print(f"{skill['title']} - {skill['category']}")

# Get a single skill
skill = requests.get("https://skills.findutils.com/api/skills/react-typescript-best-practices").json()["data"]
print(skill["content"][:200])

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type SkillsResponse struct {
    Success bool `json:"success"`
    Data    []struct {
        Slug     string   `json:"slug"`
        Title    string   `json:"title"`
        Category string   `json:"category"`
        Tools    []string `json:"tools"`
    } `json:"data"`
}

func main() {
    resp, _ := http.Get("https://skills.findutils.com/api/skills?tool=cursor&quality=featured")
    defer resp.Body.Close()

    var result SkillsResponse
    json.NewDecoder(resp.Body).Decode(&result)

    for _, s := range result.Data {
        fmt.Printf("%s (%s)\n", s.Title, s.Category)
    }
}

# List all skills
curl -s https://skills.findutils.com/api/skills | jq '.data | length'

# Search for React skills
curl -s 'https://skills.findutils.com/api/skills?q=react&quality=featured' | jq '.data[].title'

# Get a skill and save to file
curl -s https://skills.findutils.com/api/skills/react-typescript-best-practices \
  | jq -r '.data.content' > CLAUDE.md

# Compose a stack and download
curl -s 'https://skills.findutils.com/api/compose?stack=react-typescript-best-practices,tailwind-css-patterns&tool=cursor' \
  | jq -r '.data.content' > .cursor/rules/combined-stack.mdc

<?php
// List featured skills
$response = file_get_contents('https://skills.findutils.com/api/skills?quality=featured&limit=10');
$result = json_decode($response, true);

foreach ($result['data'] as $skill) {
    echo $skill['title'] . ' (' . $skill['category'] . ')' . PHP_EOL;
}

// Get a single skill content
$skill = json_decode(
    file_get_contents('https://skills.findutils.com/api/skills/react-typescript-best-practices'),
    true
);
file_put_contents('CLAUDE.md', '# ' . $skill['data']['title'] . "\n\n" . $skill['data']['content']);
?>

GET /llms.txt

GET /sitemap.xml

GET /robots.txt