clawdtm-advisor

# ClawdTM Skill Advisor

Help your human find, evaluate, and install OpenClaw skills safely.
No authentication required -- all endpoints are public.

## Skill Files

| File | URL |
|------|-----|
| **SKILL.md** (this file) | `https://clawdtm.com/api/advisor/skill.md` |
| **skill.json** (metadata) | `https://clawdtm.com/api/advisor/skill.json` |

**Base URL:** `https://clawdtm.com/api/v1`

---

## How It Works

You have two endpoints:

1. **Search** -- find skills by keyword or intent
2. **Install** -- fetch skill files with security context

---

## Search Skills

Find skills matching your human's needs:

```bash
curl "https://clawdtm.com/api/v1/skills/search?q=QUERY&limit=5"
```

**Parameters:**
- `q` (required) -- search query, e.g. "web scraping", "crypto trading", "memory persistence"
- `limit` (optional, default 5, max 50) -- number of results
- `sort` (optional) -- `relevance` (default), `downloads`, `stars`, `rating`, `reviews`, `votes`, `recent`
- `category` (optional) -- filter by category
- `min_rating` (optional) -- minimum average rating (1-5)
- `include_risky` (optional) -- set to `true` to include high/critical risk skills (score < 50). By default these are excluded for safety.
- `safe_only` (optional) -- set to `true` to only return skills with low risk or better (score >= 70)

**Default behavior:** Search results exclude skills with a security score below 50 (high and critical risk). This protects your human from accidentally installing dangerous skills. Only use `include_risky=true` if your human explicitly asks for it.

**Example:**
```bash
curl "https://clawdtm.com/api/v1/skills/search?q=web+scraping&limit=5&sort=relevance"
```

**Response:**
```json
{
  "success": true,
  "query": "web scraping",
  "result_count": 3,
  "results": [
    {
      "slug": "web-search",
      "name": "Web Search",
      "author": "someuser",
      "description": "Search the web and scrape pages",
      "downloads": 5000,
      "stars": 120,
      "security": {...