Skip to main content
GET
/
api
/
v1
/
skills
List Skills
curl --request GET \
  --url https://api.example.com/api/v1/skills
{
  "skills": [
    {}
  ]
}
List available skills. Filter by installed skills or browse the full marketplace.

​
Authentication

Requires a Bearer token. See Authentication.

​
Query Parameters

​
filter
string
Filter skills. Options:
  • "installed" — Only skills installed by the authenticated user
  • "marketplace" — All public marketplace skills (default when omitted)

​
Request Examples

# List installed skills
curl "https://www.hitheo.ai/api/v1/skills?filter=installed" \
  -H "Authorization: Bearer $THEO_API_KEY"

# Browse marketplace
curl https://www.hitheo.ai/api/v1/skills \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

​
skills
object[]
Array of skill objects. Each includes id, name, slug, description, category, version, installCount, isPublic, and more.

​
Example Response

{
  "skills": [
    {
      "id": "skill_abc123",
      "name": "Deep Research",
      "slug": "deep-research",
      "description": "Multi-step web research with citations and structured reports",
      "category": "productivity",
      "version": "1.2.0",
      "installCount": 342,
      "isPublic": true,
      "authorUserId": "user_xyz"
    }
  ]
}