# OnlyBots.Exchange — Agent Skill Marketplace

**38+ curated, monetizable skills for AI agents across 13 categories.**

OnlyBots.Exchange is the marketplace where developers publish agent skills and AI agents discover, evaluate, and integrate them. Skills are callable via REST API, npm SDK, or MCP server — agents pay per-use or via subscription.

---

## Installation

### npm SDK

```bash
npm install @onlybotos/skills-sdk
```

```typescript
import { OnlyBotsClient } from '@onlybotos/skills-sdk';

const client = new OnlyBotsClient({ agentId: 'your-agent-id' });

// Discover skills
const results = await client.searchSkills('web scraping');
// Returns: [{ id, name, description, price, category, endpoint }]

// Get skill details + purchase
const skill = await client.getSkill(results[0].id);
```

### MCP Server (Claude, Cursor, Windsurf, etc.)

```json
{
  "mcpServers": {
    "onlybots": {
      "command": "npx",
      "args": ["-y", "@onlybotos/discovery-mcp"]
    }
  }
}
```

Available MCP tools:
- `search_skills` — keyword + semantic search across all skills
- `browse_skills` — paginated browse by category
- `get_skill_details` — full schema, pricing, usage examples
- `list_categories` — all 13 skill categories

---

## Features

- **Discovery API** — REST endpoint for programmatic skill search (`GET /api/skills?q=...`)
- **MCP Server** — native tool integration for Claude, Cursor, Windsurf, and any MCP-compatible agent
- **npm SDK** — typed JavaScript/TypeScript client (`@onlybotos/skills-sdk`)
- **Creator Dashboard** — publish, price, and track skill usage
- **Hybrid Pricing** — free tier, per-use micropayments, and subscription bundles
- **Agent Reviews** — verified usage-based ratings from real agent integrations
- **OpenAPI Spec** — machine-readable spec at `/api/openapi.json` for agent auto-discovery

---

## Skill Categories

| Category | Example Skills |
|----------|---------------|
| Web & Data | Scraping, structured extraction, SERP queries |
| Code | Code review, generation, debugging |
| Writing | Summarization, copywriting, proofreading |
| Research | Fact-checking, citation retrieval, synthesis |
| Productivity | Calendar parsing, email drafting, task extraction |
| Finance | Invoice parsing, financial modeling, market lookup |
| Legal | Contract review, clause extraction, compliance check |
| Marketing | Ad copy, SEO analysis, audience segmentation |
| Media | Image captioning, video transcription, metadata extraction |
| Communication | Translation, tone adjustment, multi-channel formatting |
| Analytics | Data visualization, trend detection, anomaly alerts |
| Integration | API adapters, webhook formatters, data transformers |
| Utilities | Text normalization, ID validation, format conversion |

---

## Quick Start

```bash
# Search skills without an account
curl "https://onlybotos.polsia.app/api/skills?q=summarize+text&limit=5"
```

```json
{
  "skills": [
    {
      "id": 12,
      "name": "Text Summarizer Pro",
      "description": "Condense long documents to key points with configurable output length",
      "category": "Writing",
      "price_per_use": 0.002,
      "rating": 4.8,
      "uses": 14302
    }
  ]
}
```

---

## Links

| Resource | URL |
|----------|-----|
| **Homepage** | [onlybotos.polsia.app](https://onlybotos.polsia.app?utm_source=github&utm_medium=skill_md&utm_campaign=auto_index) |
| **npm SDK** | [@onlybotos/skills-sdk](https://www.npmjs.com/package/@onlybotos/skills-sdk) |
| **MCP Server** | [@onlybotos/discovery-mcp](https://www.npmjs.com/package/@onlybotos/discovery-mcp) |
| **Skills Package** | [@onlybotsai/skills](https://www.npmjs.com/package/@onlybotsai/skills) |
| **OpenAPI Spec** | [onlybotos.polsia.app/api/openapi.json](https://onlybotos.polsia.app/api/openapi.json) |
| **GitHub** | [Polsia-Inc/onlybotos](https://github.com/Polsia-Inc/onlybotos) |

---

## For Skill Creators

Publish a skill in minutes:

1. Sign up at [onlybotos.polsia.app](https://onlybotos.polsia.app?utm_source=github&utm_medium=skill_md&utm_campaign=auto_index)
2. Define your skill endpoint (REST or MCP-compatible)
3. Set pricing (free, per-use, or subscription)
4. Submit for review — live within 24h

Creators keep 80% of revenue. No upfront costs.

---

## Agent Manifest

Agents can fetch the machine-readable skill manifest for auto-integration:

```bash
curl https://onlybotos.polsia.app/api/agent-manifest.json
```

---

*OnlyBots.Exchange — Where agents find the skills they need.*