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

# Agent Skills

> Install a Thrad skill so your coding agent integrates the API for you.

Hand your coding agent a **skill** instead of documentation — a single Markdown file it loads whenever you ask it to work on Thrad, so it builds against the real request shape and tracking rules instead of guessing.

| Skill | What it integrates | Raw file |
| - | - | - |
| `thrad-card` | The ad card on the v2 API — bid request, rendering, click and impression tracking | [SKILL.md](https://docs.thrads.ai/skills/thrad-card/SKILL.md) |
| `thrad-poll` | The poll — poll inventory, signed vote endpoint | [SKILL.md](https://docs.thrads.ai/skills/thrad-poll/SKILL.md) |
| `thrad-carousel` | The carousel — 3–5 product cards, per-item click tracking, single impression ping | [SKILL.md](https://docs.thrads.ai/skills/thrad-carousel/SKILL.md) |

## Install

Paste this into your agent (swap the name for `thrad-poll` or `thrad-carousel`). Each skill is self-contained: it covers the whole integration for its format, so install just the ones your UI can show:

```text theme={null}
I want to integrate Thrad. Create a skill named thrad-card in this project with exactly this content, then follow it:

---
name: thrad-card
description: Integrate Thrad's ad card via the v2 bid-request API — request, render, and track native ads in an AI chat app. Triggers on "Thrad", "ad card", "monetize my chatbot", "bid request".
---

# Thrad Card

Fetch https://docs.thrads.ai/skills/thrad-card/SKILL.md and follow it in full.
That URL is the canonical, always-current instructions — always fetch it before starting.
```

The file is a **pointer**: it fetches the current instructions each time, so it never goes stale and there's nothing to re-install when we ship changes. Commit it to the repo and it travels with the project. In a chat interface with no filesystem, just paste the raw URL and ask the agent to follow it.

The skills stop and ask for your **staging** API key (placeholders 401) — grab it from the [platform dashboard](https://platform.thrad.ai/signup?role=pub). They build and verify against staging, then tell you to swap in the production key at launch.

Questions or a format you'd like a skill for: **[contact@thrad.ai](mailto:contact@thrad.ai)**

## Next steps

> [card] [Ad Formats & Rendering](https://docs.thrad.ai/api/guides/rendering-v2.md)
>
> Cards, carousels, polls, and how to draw and track each.

> [card] [User & Chat Identification](https://docs.thrad.ai/api/guides/user-identification-v2.md)
>
> Which ids to send, and why they raise your revenue.

Need exact fields? The [API Reference](https://docs.thrad.ai/api/api-reference/bid-request-v2.md) has every request and response.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.