스킬 API

스킬 목록, 검색, 조회를 위한 엔드포인트입니다.

스킬 목록

GET /api/v1/skills

파라미터

| 파라미터 | 타입 | 설명 | |-----------|------|-------------| | page | number | 페이지 번호 (기본값: 1) | | limit | number | 페이지당 항목 수 (기본값: 20, 최대: 100) | | sort | string | 정렬 기준: stars, updated, name | | order | string | 정렬 순서: asc, desc | | category | string | 카테고리 슬러그로 필터 | | platform | string | 플랫폼으로 필터 |

요청 예시

bash

curl "https://skillsmp.com/api/v1/skills?category=development&sort=stars&order=desc&limit=10"

응답 예시

json

{
  "data": [
    {
      "id": "123",
      "owner": "anthropic",
      "repo": "brand-guidelines",
      "name": "Brand Guidelines",
      "description": "Maintain consistent brand identity",
      "stars": 1250,
      "forks": 89,
      "updatedAt": "2024-01-15T10:30:00Z",
      "categories": ["marketing", "design"],
      "platforms": ["claude-code", "codex", "chatgpt"]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 150,
    "totalPages": 15
  }
}

스킬 조회

GET /api/v1/skills/:owner/:repo

요청 예시

bash

curl https://skillsmp.com/api/v1/skills/anthropic/brand-guidelines

응답 예시

json

{
  "data": {
    "id": "123",
    "owner": "anthropic",
    "repo": "brand-guidelines",
    "name": "Brand Guidelines",
    "description": "Maintain consistent brand identity across all AI-generated content",
    "content": "# Brand Guidelines\n\n## Overview...",
    "stars": 1250,
    "forks": 89,
    "watchers": 45,
    "openIssues": 3,
    "license": "MIT",
    "createdAt": "2023-06-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z",
    "pushedAt": "2024-01-14T15:00:00Z",
    "categories": ["marketing", "design"],
    "platforms": ["claude-code", "codex", "chatgpt"],
    "author": {
      "name": "Anthropic",
      "avatar": "https://github.com/anthropic.png"
    },
    "installCommands": {
      "claudeCode": "claude skill add anthropic/brand-guidelines",
      "codex": "codex config add-skill anthropic/brand-guidelines",
      "chatgpt": "Copy to Custom Instructions"
    }
  }
}

스킬 내용 조회

GET /api/v1/skills/:owner/:repo/content

원시 SKILL.md 내용을 반환합니다.

요청 예시

bash

curl https://skillsmp.com/api/v1/skills/anthropic/brand-guidelines/content

응답 예시

json

{
  "data": {
    "content": "---\nname: Brand Guidelines\n...",
    "sha": "abc123def",
    "size": 4523
  }
}

스킬 통계 조회

GET /api/v1/skills/:owner/:repo/stats

응답 예시

json

{
  "data": {
    "views": 15234,
    "installs": 3456,
    "favorites": 789,
    "starHistory": [
      {"date": "2024-01-01", "stars": 1100},
      {"date": "2024-01-08", "stars": 1150},
      {"date": "2024-01-15", "stars": 1250}
    ]
  }
}

오류 코드

| 코드 | HTTP 상태 | 설명 | |------|-------------|-------------| | NOT_FOUND | 404 | 스킬이 존재하지 않음 | | INVALID_PARAMS | 400 | 잘못된 쿼리 파라미터 | | RATE_LIMITED | 429 | 요청이 너무 많음 | | SERVER_ERROR | 500 | 내부 오류 |