---
name: evolution-foundation/knowledge-browse
source: https://app.decimal.ai/s/evolution-foundation-knowledge-browse@1/SKILL.md
source_sha256: 05e98bcfa79a
---

# knowledge-browse

Group: **Curation**. List/filter documents + units.

## When to trigger

- "What's in space X"
- "List the last 10 indexed docs"
- "Which documents have error status"
- "Show Academy units"

## Arguments

| Name | Type | Default | Description |
|---|---|---|---|
| `scope` | str | "documents" | "documents" OR "units" |
| `connection` | str | first ready | Target connection |
| `space` | str | null | Filter by space slug |
| `unit_id` | str | null | Filter by unit |
| `content_type` | str | null | lesson/tutorial/faq/reference/... |
| `difficulty` | str | null | beginner/intermediate/advanced |
| `topics` | list[str] | null | Filter by tags |
| `status` | str | null | pending/processing/ready/error |
| `q` | str | null | Text search on title |
| `limit` | int | 20 | How many to return |

## Workflow

### Step 1 — Call the right endpoint

```python
from dashboard.backend.sdk_client import evo

if scope == "documents":
    params = {k: v for k, v in {
        "space": space, "unit_id": unit_id, "content_type": content_type,
        "difficulty": difficulty, "topics": ",".join(topics or []),
        "status": status, "q": q, "limit": limit,
    }.items() if v is not None}
    items = evo.get("/api/knowledge/v1/documents", params=params,
                    headers={"X-Knowledge-Connection": connection})
elif scope == "units":
    params = {"space": space, "limit": limit}
    items = evo.get("/api/knowledge/v1/units", params=params,
                    headers={"X-Knowledge-Connection": connection})
```

### Step 2 — Render markdown table

Documents:

```
| Title | Type | Difficulty | Topics | Chunks | Status | Added |
|---|---|---|---|---|---|---|
| ... | lesson | beginner | [whatsapp, auth] | 14 | ready | 2026-04-20 |
```

Units:

```
| Title | Slug | Space | Seq | Docs | Created |
|---|---|---|---|---|---|
| ... | ... | academy | 1 | 5 | 2026-04-15 |
```

### Step 3 — Footer

```
Showing {len(items)} of {total} {scope} in {connection}{/space if filtered}.
Filters applied: {filters_summary}.
```

## Actionable failures

- 0 results → suggest relaxing filters
- Space not found → list available spaces
- Connection not found → "Run `knowledge-admin action=health`"