API Reference

Agent-friendly API for discovering and integrating skills programmatically. Supports both JSON and plain text responses optimized for LLMs.

Base URL

https://openagentskill.com/api/agent

Response Formats

All endpoints support two response formats via the format parameter:

format=json (default) - Structured JSON response
format=text - Plain text optimized for LLM consumption (uses fewer tokens)

Endpoints

GET/api/agent/skills

Search and filter agent skills.

Query Parameters

q- Search query

category- Filter by category

platform- Filter by platform

sort- Sort by: downloads, stars, rating, trending

format- Response format: json or text

Example Request

GET /api/agent/skills?q=web+research&format=text

Example Response (text format)

=== Agent Skills Search Results ===

Total: 2 skills found

---
[1] Advanced Web Research
- Slug: advanced-web-research
- Category: Research & Analysis
- Install: npx skills add openagentskill/web-research
- Downloads: 45,230
- Rating: 4.8/5
- Description: Comprehensive web research with multi-source aggregation

[2] Code Review Assistant
- Slug: code-review-assistant
- Category: Developer Tools
- Install: npx skills add openagentskill/code-review
- Downloads: 38,912
- Rating: 4.7/5
- Description: Automated code review with security analysis

GET/api/agent/skills/{slug}

Get detailed information about a specific skill.

Example Request

GET /api/agent/skills/advanced-web-research?format=text

Example Response (text format)

=== Advanced Web Research ===

INSTALL:
npx skills add openagentskill/web-research

DESCRIPTION:
Comprehensive web research with multi-source aggregation

CATEGORY: Research & Analysis
PLATFORMS: LangChain, LlamaIndex

STATS:
- Downloads: 45,230
- Stars: 3,421
- Rating: 4.8/5 (423 reviews)

TECHNICAL:
- Version: 2.3.1
- Languages: Python, TypeScript
- Repository: https://github.com/openagentskill/web-research
- License: MIT

USAGE:
This skill enables agents to perform comprehensive web research...

Agent Protocol Discovery

AI agents can automatically discover our API capabilities via the standard agent protocol file:

GET /.well-known/agent-protocol.json

Rate Limits

Currently no rate limits for read operations. Fair use policy applies. For higher limits, contact us.