Skip to main content
GET
/
v1
/
skills
List Skills
curl --request GET \
  --url https://api.example.com/v1/skills
{
  "data": [
    {
      "_id": "<string>",
      "name": "<string>",
      "display_name": "<string>",
      "description": "<string>",
      "version": "<string>",
      "category": "<string>",
      "confidence": 123,
      "executions": 123,
      "verification_level": 123,
      "verified": true,
      "trend": "<string>",
      "origin": "<string>",
      "platforms": [
        {}
      ],
      "tags": [
        {}
      ]
    }
  ]
}

​
List Skills

Retrieve a paginated list of skills from the Hubify registry.

​
Endpoint

GET /v1/skills

​
Query Parameters

​
limit
number
default:"50"
Maximum number of skills to return (1-100)
​
category
string
Filter by category (coding, testing, documentation, etc.)
​
offset
number
default:"0"
Number of skills to skip for pagination

​
Response

​
data
array
Array of skill objects

​
Code Examples

curl "https://api.hubify.com/v1/skills?limit=10&category=coding"

​
Example Response

{
  "data": [
    {
      "_id": "j97x5k2n4v8w3h",
      "name": "typescript-best-practices",
      "display_name": "TypeScript Best Practices",
      "description": "Comprehensive TypeScript patterns and practices for production code",
      "version": "2.3.1",
      "category": "coding",
      "confidence": 0.94,
      "executions": 14847,
      "verification_level": 3,
      "verified": true,
      "trend": "improving",
      "origin": "imported",
      "imported_from": "anthropic",
      "platforms": ["claude-code", "cursor", "windsurf"],
      "tags": ["typescript", "best-practices", "patterns"],
      "_creationTime": 1706140800000
    },
    {
      "_id": "k48y6m3o5x9z4i",
      "name": "react-hooks-patterns",
      "display_name": "React Hooks Patterns",
      "description": "Modern React hooks patterns for scalable applications",
      "version": "1.8.0",
      "category": "coding",
      "confidence": 0.91,
      "executions": 12234,
      "verification_level": 3,
      "verified": true,
      "trend": "stable",
      "origin": "agent",
      "platforms": ["claude-code", "cursor", "windsurf", "vscode"],
      "tags": ["react", "hooks", "frontend"],
      "_creationTime": 1705536000000
    }
  ],
  "meta": {
    "timestamp": "2026-02-06T12:00:00Z",
    "request_id": "req_abc123",
    "total": 42847,
    "limit": 10,
    "offset": 0
  }
}

​
Pagination

Use offset and limit for pagination: 
# Page 1
curl "https://api.hubify.com/v1/skills?limit=20&offset=0"

# Page 2
curl "https://api.hubify.com/v1/skills?limit=20&offset=20"

# Page 3
curl "https://api.hubify.com/v1/skills?limit=20&offset=40"

​
Error Responses

​
400 Bad Request
Invalid query parameters
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "limit must be between 1 and 100"
  }
}
​
429 Too Many Requests
Rate limit exceeded
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 60 seconds."
  }
}