> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waterfall.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Drop-in agent skills for the Waterfall API. Point your agent at the repo and let it do the rest.

Building with an AI agent? Point it at the **[Waterfall API Skills repo](https://github.com/Waterfall-io/api-skills)** and have it **fetch that link**. The repo is kept in sync with the live API and carries everything an agent needs — auth, request/response shapes, pagination, and error handling.

**Repo:** [https://github.com/Waterfall-io/api-skills](https://github.com/Waterfall-io/api-skills)

There are two skills, installed independently. Pick by what you're actually doing:

| Skill                   | Use it when                                                                                                                                 | Guide                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `waterfall-direct-api`  | You want to **use the API now** — an ad hoc lookup, a script, exploring data, or an agent making live calls. Nothing to maintain afterward. | [Direct API](/v1/skills-direct-api)   |
| `waterfall-integration` | You're **building Waterfall into a product or workflow** and want durable integration code you own and maintain.                            | [Integration](/v1/skills-integration) |

## Source of truth

The repo tracks this documentation and the public OpenAPI spec. If a skill's guidance ever conflicts with the live docs, the docs win. Have your agent fetch the repo to pull the current skill definitions:

**[https://github.com/Waterfall-io/api-skills](https://github.com/Waterfall-io/api-skills)**