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

# Agent Skill

> Use Nia without MCP server — your agent calls API endpoints directly through a skill.

The Nia Agent Skill allows you to use Nia without running an MCP server. Instead, your agent calls the Nia API endpoints directly through the skill file, giving you a lightweight alternative to the full MCP setup.

<Info>
  **No Server Required**: The skill approach doesn't require running any background process—your agent reads the skill file and makes API calls directly.
</Info>

***

## How It Works

When you install the Nia skill, it provides your agent with:

* **API endpoint definitions** for all Nia features
* **Authentication instructions** for using your API key
* **Usage examples** the agent can follow

Your agent reads the skill file and uses it as a reference to make HTTP requests directly to the Nia API, bypassing the need for an MCP server.

***

## Installation

Install the Nia skill in non-interactive mode (recommended for agents/automation):

```bash theme={null}
npx nia-wizard skill add \
  --api-key "nk_your_api_key" \
  --source nozomio-labs/nia-skill \
  --non-interactive \
  --ci
```

Optional target pinning:

```bash theme={null}
npx nia-wizard skill add \
  --api-key "nk_your_api_key" \
  --target codex \
  --non-interactive \
  --ci
```

Manual installation via skills CLI:

```bash theme={null}
npx skills add nozomio-labs/nia-skill        # npm
pnpx skills add nozomio-labs/nia-skill       # pnpm
bunx skills add nozomio-labs/nia-skill       # bun (fastest)
yarn dlx skills add nozomio-labs/nia-skill   # yarn
```

***

## Setup

### 1. Get Your API Key

Sign up at [trynia.ai](https://trynia.ai) to get your API key.

For full headless onboarding (API signup/login + non-interactive install), use the [Agent Onboarding guide](/agent-onboarding).

### 2. Configure Your Agent

The skill will instruct your agent how to authenticate. Typically, you'll set your API key in one of these ways:

* Environment variable: `NIA_API_KEY`
* Config file: `~/.config/nia/api_key`

***

## Links

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/nozomio-labs/nia-skill">
    View skill source code
  </Card>

  <Card title="Get API Key" icon="key" href="https://app.trynia.ai">
    Sign up for Nia API access
  </Card>
</CardGroup>

***

<Warning>
  **Need Help?** Join our [Discord community](https://discord.gg/BBSwUMrrfn) for support.
</Warning>