# Nia

Puts repositories, docs, papers, datasets and chat workspaces into an index, then searches them through the Nia API. Useful when the agent needs the real source instead of a trimmed web page.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 56200 installs · ★ 26
- Author: nozomio-labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nozomio-labs/nia-skill/tree/HEAD/SKILL.md
- Updated: 2026-03-29
- HTML: https://affpapa.org/en/nevibecode/skills/nia

## What it does

The skill wires your agent to the Nia API through a set of wrappers in `./scripts/`. With them you add a source to the index, list what is already there, read a file, grep its contents or walk the file tree. Repositories, documentation, Slack, Google Drive and X each get their own script, and `nia.sh sources` prints the whole inventory in one call.

The workflow it enforces is check-first: look for the source in the index before reaching for the web. The reasoning is that an indexed source hands back complete code and docs, while a web fetch gives you a shortened version. One caveat is spelled out — `search.sh universal` does not cover Slack, so use `search.sh query` with the `SLACK_WORKSPACES` variable or `slack.sh` instead.

You need a key before anything runs: `NIA_API_KEY` in the environment or a file at `~/.config/nia/api_key`, and the environment variable wins if both exist. Get one through `auth.sh signup` plus `auth.sh bootstrap-key`, through `npx nia-wizard@latest`, or by signing up on the site. The only dependencies are `curl` and `jq`. Indexing a source takes 1-5 minutes, so searching it right away gets you nothing.

## Requirements
- Works with: GitHub, Slack, Google Drive

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add nozomio-labs/nia-skill --skill nia -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/nia/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/nia/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add nozomio-labs/nia-skill --skill nia -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/nia/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add nozomio-labs/nia-skill --skill nia -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/nia/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nozomio-labs/nia-skill nia
```

2. **Manually: put the files in place**
- File: `.github/skills/nia/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add nozomio-labs/nia-skill --skill nia -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/nozomio-labs/nia-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/nia/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add nozomio-labs/nia-skill --skill nia -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nozomio-labs/nia-skill/tree/HEAD/SKILL.md

## When to use it
- find a function in a third-party repo without cloning it
- read a docs page in full instead of a search snippet
- keep papers, datasets and team chats in one searchable place
- check what is already indexed before hitting the web
- push a PDF or spreadsheet into the index via a signed URL

## Example prompts
- Run `./scripts/nia.sh sources` and tell me what is indexed, then find queue examples there
- Index `https://docs.example.com` and show me the file tree
- Search Slack with `SLACK_WORKSPACES` for anything about the deploy

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md