---
name: yaoapp-yao-doc
description: "Yao process documentation expert. ALWAYS invoke this skill when the user needs to discover available processes, read process signatures, or validate process names. Do not guess process APIs — use this skill first."
license: "NOASSERTION"
metadata:
  decimalai-skill-id: "8aed0556-9600-4a52-945d-d87ac0961e9e"
  decimalai-version-id: "7fcdb807-65b5-4f9c-a009-da1e34b0828e"
  decimalai-version: "1"
  decimalai-body-sha256: "d2b3db4cd7895cc1c5d98a85d8c37e8752cb88cd09cbfa579e503ad68c809c92"
  decimalai-name: "yaoapp/yao-doc"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/yaoapp-yao-doc@1/SKILL.md"
---
# Documentation Tools

Three tools for browsing Yao process documentation, called via bash.

## doc_list

Search and list available process documentation entries.

```bash
tai tool doc_list '{"keyword": "user", "limit": 10}'
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keyword` | string | no | Search keyword (empty to list all) |
| `limit` | integer | no | Max results (default 20) |

## doc_inspect

Get detailed documentation for a specific process: arguments, return type, methods.

```bash
tai tool doc_inspect '{"name": "models.user.Find"}'
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | yes | Process name (e.g. `models.user.Find`) |

## doc_validate

Check if a process name is valid. Returns suggestions for similar processes if not found.

```bash
tai tool doc_validate '{"name": "models.user.Findd"}'
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | yes | Process name to validate |

## Workflow

1. **doc_list** — discover available processes by keyword
2. **doc_inspect** — read the full signature before calling
3. **doc_validate** — fix typos when a process name doesn't work

## Guidelines

- Always use doc_inspect before calling an unfamiliar process via process_call
- Use doc_validate when you get unexpected errors — the name might be misspelled