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

# Agent Skills

> Install the Waniwani SDK skill for Claude Code, Cursor, and other AI agents.

The Waniwani SDK is available as an [agent skill](https://agentskills.io) for Claude Code, Cursor, GitHub Copilot, and 20+ other AI coding agents. Once installed, your agent knows how to integrate the SDK without you having to explain the API.

<Columns cols={2}>
  <Card title="Waniwani SDK" icon="code" href="#waniwani-sdk">
    Tracking, flows, widgets, knowledge base, and chat components.
  </Card>

  <Card title="OpenAI Submission" icon="file-check" href="#openai-app-submission">
    Generate Tool Justification and Test Cases for the ChatGPT Plugin Store.
  </Card>
</Columns>

## Waniwani SDK

### Install

<CodeGroup>
  ```bash npx theme={null}
  npx skills add Waniwani-AI/sdk -s waniwani-sdk
  ```

  ```bash bunx theme={null}
  bunx skills add Waniwani-AI/sdk -s waniwani-sdk
  ```
</CodeGroup>

The skill is installed into your project's `.claude/skills/` directory (or equivalent for other agents).

### What's included

The skill teaches your agent how to:

* **Set up the SDK** -- install, configure env vars, create a client singleton
* **Track events** -- `withWaniwani` auto-tracking, custom events, sessions
* **Build flows** -- multi-step conversational state machines with interrupts, validation, conditional edges
* **Create tools with widgets** -- `createResource`, `createTool`, React hooks for widget UIs
* **Add a knowledge base** -- ingest markdown, search with embeddings, build FAQ tools
* **Embed chat** -- React component and script-tag embed with theming

### Usage

After installing, just describe what you want in natural language. Your agent will use the skill automatically:

* *"Add Waniwani tracking to my MCP server"*
* *"Create a multi-step onboarding flow"*
* *"Add a knowledge base FAQ tool"*
* *"Embed a chat widget on my landing page"*

## OpenAI App Submission

When submitting your MCP server to the ChatGPT Plugin Store, you need to provide Tool Justification and Test Cases documents. The Waniwani dashboard handles this for you: go to your project's submission page and use the built-in Codex assistant to generate a `chatgpt-app-submission.json` file, then upload it to auto-fill the form.

The generated file includes:

1. **Tool Justification** -- annotations (Read Only, Open World, Destructive) with justifications for every tool
2. **Test Cases** -- positive and negative test scenarios for OpenAI reviewers

## Learn more

* [skills.sh](https://skills.sh) -- Browse and discover agent skills
* [agentskills.io](https://agentskills.io) -- The open Agent Skills specification