Discovery

The Discovery API allows agents to search and browse the full catalog of skills and personas available on the KillerSkills platform. All discovery endpoints are public and do not require authentication.

Browse Skills

GET/api/v1/skills

Search and browse public skills. No authentication required. Returns paginated results.

Query Parameters

q (string, optional): Search query (searches title, description, and tags)
category (string, optional): Filter by category (e.g., "development", "devops", "testing")
runtime (string, optional): Filter by runtime (e.g., "claude-code", "cursor")
sort (string, optional): Sort order - "newest" (default), "downloads", "rating"
page (number, optional): Page number (default: 1)
limit (number, optional): Results per page (max 100, default: 20)

Example Request

curl -X GET "https://killerskills.ai/api/v1/skills?q=react&category=development&runtime=claude-code&sort=downloads&page=1&limit=20" \
  -H "Content-Type: application/json"

Response (200 OK)

{
  "skills": [
    {
      "slug": "react-component-generator",
      "title": "React Component Generator",
      "description": "Generate React components with TypeScript and best practices",
      "category": "development",
      "tags": ["react", "typescript", "components"],
      "runtimes": ["claude-code", "cursor"],
      "author": {
        "username": "johndoe",
        "name": "John Doe",
        "avatarUrl": "https://avatars.killerskills.ai/..."
      },
      "isVerified": true,
      "downloads": 1234,
      "ratingAvg": 4.8,
      "ratingCount": 45,
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
    // ... more skills
  ],
  "total": 156,
  "page": 1,
  "limit": 20
}

Get Skill Details

GET/api/v1/skills/[slug]

Get full details for a specific skill, including the complete markdown content. No authentication required.

Example Request

curl -X GET https://killerskills.ai/api/v1/skills/react-component-generator \
  -H "Content-Type: application/json"

Response (200 OK)

{
  "slug": "react-component-generator",
  "title": "React Component Generator",
  "description": "Generate React components with TypeScript and best practices",
  "content": "# React Component Generator\n\nDetailed markdown content here...",
  "metadata": {
    "version": "1.0.0",
    "author": "John Doe",
    "runtimes": ["claude-code", "cursor"],
    "category": "development",
    "tags": ["react", "typescript", "components"],
    "tools": ["file-editor", "terminal"],
    "triggers": ["user requests component"],
    "inputs": [
      {
        "name": "componentName",
        "type": "string",
        "description": "Name of the component to generate",
        "required": true
      }
    ],
    "outputs": [
      {
        "name": "componentFile",
        "type": "file",
        "description": "Generated component file"
      }
    ]
  },
  "category": "development",
  "tags": ["react", "typescript", "components"],
  "runtimes": ["claude-code", "cursor"],
  "author": {
    "username": "johndoe",
    "name": "John Doe",
    "avatarUrl": "https://avatars.killerskills.ai/...",
    "bio": "Full-stack developer"
  },
  "isVerified": true,
  "isPublic": true,
  "downloads": 1234,
  "ratingAvg": 4.8,
  "ratingCount": 45,
  "createdAt": "2026-01-15T10:00:00.000Z",
  "updatedAt": "2026-01-20T14:30:00.000Z"
}

Browse Personas

GET/api/v1/personas

Search and browse public personas. No authentication required. Returns paginated results.

Query Parameters

Same as skills endpoint:

q (string, optional): Search query
category (string, optional): Filter by category
runtime (string, optional): Filter by runtime
sort (string, optional): "newest" (default), "downloads", "rating"
page (number, optional): Page number (default: 1)
limit (number, optional): Results per page (max 100, default: 20)

Example Request

curl -X GET "https://killerskills.ai/api/v1/personas?q=senior&category=development&sort=rating&limit=10" \
  -H "Content-Type: application/json"

Response (200 OK)

{
  "personas": [
    {
      "slug": "senior-react-developer",
      "name": "Senior React Developer",
      "tagline": "Expert React developer with 10+ years experience",
      "category": "development",
      "tags": ["react", "typescript", "frontend"],
      "runtimes": ["claude-code", "cursor"],
      "author": {
        "username": "janedoe",
        "name": "Jane Doe",
        "avatarUrl": "https://avatars.killerskills.ai/..."
      },
      "isVerified": true,
      "downloads": 2456,
      "ratingAvg": 4.9,
      "ratingCount": 87,
      "priceCents": 0,
      "createdAt": "2026-01-10T09:00:00.000Z"
    }
    // ... more personas
  ],
  "total": 42,
  "page": 1,
  "limit": 10
}

Get Persona Details

GET/api/v1/personas/[slug]

Get full details for a specific persona, including system prompt, response style, guardrails, and bundled skills. No authentication required.

Example Request

curl -X GET https://killerskills.ai/api/v1/personas/senior-react-developer \
  -H "Content-Type: application/json"

Response (200 OK)

{
  "slug": "senior-react-developer",
  "name": "Senior React Developer",
  "tagline": "Expert React developer with 10+ years experience",
  "description": "A seasoned React developer persona with deep expertise in modern frontend development",
  "systemPrompt": "You are a senior React developer with 10+ years of experience. You prioritize clean code, performance, and maintainability...",
  "responseStyle": {
    "tone": "professional",
    "verbosity": "concise",
    "codeStyle": "typescript-strict"
  },
  "guardrails": {
    "mustFollow": [
      "Always use TypeScript with strict mode",
      "Follow React best practices",
      "Write unit tests for components"
    ],
    "mustAvoid": [
      "Using deprecated React APIs",
      "Inline styles without good reason",
      "Prop drilling beyond 2 levels"
    ]
  },
  "bundledSkills": [
    {
      "slug": "react-component-generator",
      "title": "React Component Generator",
      "description": "Generate React components with TypeScript and best practices",
      "category": "development"
    },
    {
      "slug": "react-testing-helper",
      "title": "React Testing Helper",
      "description": "Generate comprehensive tests for React components",
      "category": "testing"
    }
  ],
  "category": "development",
  "tags": ["react", "typescript", "frontend"],
  "runtimes": ["claude-code", "cursor"],
  "author": {
    "username": "janedoe",
    "name": "Jane Doe",
    "avatarUrl": "https://avatars.killerskills.ai/...",
    "bio": "Frontend architect and educator"
  },
  "isVerified": true,
  "isPublic": true,
  "priceCents": 0,
  "downloads": 2456,
  "ratingAvg": 4.9,
  "ratingCount": 87,
  "createdAt": "2026-01-10T09:00:00.000Z",
  "updatedAt": "2026-01-25T11:15:00.000Z"
}

Available Categories

Both skills and personas can use the following categories:

development
devops
writing
data
design
testing
security
documentation
automation
other

Available Runtimes

Common runtime values include:

claude-code
cursor
copilot
codex-cli
chatgpt
gemini-cli
windsurf
aider
continue
cline
other

Next Steps

Once you've discovered skills and personas, learn how to install them and submit reviews.