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

# Quick Start

> Install Ollang Skills and run your first translation in under 2 minutes.

# Quick Start

Add Ollang Skills to your AI agent in one command.

## Prerequisites

* An [Ollang account](https://lab.ollang.com) (free to sign up)
* An Ollang API key (generate one in the [Olabs Dashboard](https://lab.ollang.com))
* A compatible AI coding agent (Cursor, Claude Code, Codex, Windsurf, Cline, or similar)
* [Node.js](https://nodejs.org/) installed (for the `npx` command)

## Installation

<Tabs>
  <Tab title="One Command">
    Run this in your project root (or anywhere your agent can read files):

    ```bash theme={null}
    npx skills add https://github.com/ollang/skills --skill ollang
    ```

    This downloads the Ollang master skill and all 12 sub-skills into your local skills directory.
  </Tab>

  <Tab title="Shorthand">
    If you have the skills CLI cached:

    ```bash theme={null}
    npx skills add ollang/skills
    ```
  </Tab>
</Tabs>

## Verify Installation

After installing, you should see an `ollang` skill folder in your project's `.skills/` or `.cursor/skills/` directory (location depends on your agent). Confirm by asking your agent:

```
Check if the Ollang API is healthy.
```

The agent will use the `ollang-health` sub-skill to ping the API and confirm connectivity.

## Set Your API Key

Provide your Ollang API key so the agent can authenticate:

```
My Ollang API key is olk_xxxxxxxxxxxx
```

The agent stores this in-session. For persistent configuration, set the `OLLANG_API_KEY` environment variable or add it to your project's `.env`:

```bash .env theme={null}
OLLANG_API_KEY=olk_xxxxxxxxxxxx
```

## Your First Translation

Try asking your agent:

```
Upload the video at https://example.com/intro.mp4 to Ollang
and create a subtitle order for French and Japanese.
```

The agent will:

1. Call **ollang-upload** to upload the video → returns a `projectId`
2. Call **ollang-order-create** with subtitle type and `fr` + `ja` targets → returns order IDs
3. Report back the order details and suggest checking status later

## Example Prompts

<AccordionGroup>
  <Accordion title="Upload and translate a document">
    ```
    Upload contract.pdf to Ollang and create a document translation
    order for Spanish and German.
    ```
  </Accordion>

  <Accordion title="Check order status">
    ```
    What's the status of Ollang order #12345?
    ```
  </Accordion>

  <Accordion title="Run a QC evaluation">
    ```
    Run a quality check on order #12345 for accuracy and fluency.
    ```
  </Accordion>

  <Accordion title="List recent orders">
    ```
    Show me my last 10 Ollang orders.
    ```
  </Accordion>

  <Accordion title="Request human review">
    ```
    Request human review for order #12345.
    ```
  </Accordion>

  <Accordion title="Create a revision">
    ```
    Report a timing issue on order #12345 — the subtitle at 01:23 is
    2 seconds late.
    ```
  </Accordion>
</AccordionGroup>

## Updating Skills

To pull the latest version of Ollang Skills:

```bash theme={null}
npx skills update
```

Or check for updates first:

```bash theme={null}
npx skills check
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Sub-Skills Reference" icon="list" href="/skills/sub-skills">
    See all 12 sub-skills and their parameters.
  </Card>

  <Card title="Ollang API Reference" icon="book-open-cover" href="/apis/ollang-api-reference/direct-file-upload">
    Full REST API docs for advanced usage.
  </Card>
</CardGroup>