Nia skill for Claude Code: index repos, docs and folders, then search them with Nia

Makes Claude index and search repositories, docs, papers, local folders, Slack and Google Drive through Nia's hosted service.

Installs: 56.2K; on skills.sh
Stars: 26; on GitHub
Updated: Mar 2026; last commit

Nia is a skill that wraps the Nia API (trynia.ai) in 25 shell scripts. Claude indexes a repo, docs site, paper, dataset, local folder, Slack workspace or Drive, then greps, reads and asks questions of that index. SKILL.md tells Claude to check Nia first and never skip to web search. It needs an API key, curl and jq, and indexing sends your content to Nia's servers.

Good for

Developers who want Claude to search indexed docs and source before the open web
Researchers indexing arXiv papers and Hugging Face datasets
Teams that want Slack or Drive content searchable by Claude

Install Nia

Claude Code

Copy this prompt.

Install the Nia skill in Claude Code. Run this command:

npx skills add nozomio-labs/nia-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, curl, jq.

Get a key in one of the ways the README lists: sign up at trynia.ai, run npx nia-wizard@latest for guided setup, or use the bundled scripts/auth.sh signup and bootstrap-key or login-key commands. Then export NIA_API_KEY or write the key to ~/.config/nia/api_key. The scripts need curl and jq.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Index and search code repositories, documentation, research papers, HuggingFace datasets, local folders, Slack workspaces, Google Drive, X (Twitter), and packages with Nia AI. Includes auth bootstrapping, Oracle autonomous research, GitHub live search, Tracer agent, dependency analysis, context sharing, code advisor, document agent, data extraction, filesystem operations, and generic connectors.

Sections in SKILL.md

Setup
Get your API key
Store the key
Requirements
Notes
Scripts
nia.sh — Unified Entry Point
auth.sh — Programmatic Signup & API Key Bootstrap
sources.sh — Documentation & Data Source Management
repos.sh — Repository Management
search.sh — Search
oracle.sh — Oracle Autonomous Research (Pro)
tracer.sh — Tracer GitHub Code Search (Pro)
slack.sh — Slack Integration
google-drive.sh — Google Drive Integration
x.sh — X (Twitter) Integration

Key facts

Author: nozomio-labs (owner of the GitHub repo; the organization says it makes Nia); the SKILL.md homepage is trynia.ai
License: MIT per the README; the repo has no LICENSE file
Installs on skills.sh: 56,243 as of 2026-11-02
GitHub stars: 26, 2026-11-02
What is inside: 27 files including SKILL.md: README.md and 25 shell scripts in scripts/
Needs: A Nia API key (NIA_API_KEY or ~/.config/nia/api_key), curl and jq
Scripts: SKILL.md documents 24 script sections; the README table lists 18
Last repo commit: 2026-03-29
Works in: The README names no specific agent; it describes an AI agent skill run with ./scripts/

What it includes

Check what is indexed before any web search
SKILL.md opens by telling Claude never to use web fetch or web search before checking Nia sources, and lists six steps from nia.sh sources through to search.sh web or deep as a last resort.
Read · Nia-first workflow
Inventory of indexed sources and API usage summary
nia.sh sources prints counts and recent names for every source type. usage.sh shows an API usage summary.
Network · nia.sh and usage.sh
Index, list, read, grep and tree GitHub repositories
Indexes an owner/repo with Nia, then reads files and searches code. It can delete or rename repositories you indexed.
Try: “Index vercel/ai with Nia and find where streamText is defined.”
Write · repos.sh
Index docs, datasets and other sources, then read and grep them
Indexes a documentation site root, lists, syncs, reads and greps sources, edits annotations and trust settings, and bulk-deletes. Docs are added as global sources by default.
Try: “Index docs.stripe.com and search it for webhook signature checks.”
Write · sources.sh
Query sources, search all indexed sources, web search, deep research
query is the only search that includes Slack. universal covers repos, docs and datasets. web and deep search outside Nia, and deep is marked Pro.
Network · search.sh
Autonomous research jobs and live GitHub code search (Pro)
Both start asynchronous jobs on Nia's side that you poll or stream. SKILL.md marks them Pro.
Network · oracle.sh and tracer.sh
Connect Slack, Google Drive, X and other connectors
Slack by OAuth or a bot token you register, Drive by OAuth with browse, select and index, X by a bearer token, plus a generic connector installer. Nia indexes what you select.
Write · slack.sh, google-drive.sh, x.sh, connectors.sh
Live GitHub search, arXiv papers, Hugging Face datasets, package source
github.sh searches without indexing, papers.sh and datasets.sh index sources, and packages.sh greps npm, PyPI, crates.io, Go and RubyGems package code.
Network · github.sh, papers.sh, datasets.sh, packages.sh
Upload a local folder or database file as a private source
create reads the text files in a local directory, skipping dotfiles, and sends their contents to Nia. create-db sends a database file base64-encoded. sync re-uploads from the local folder.
Try: “Upload ./docs to Nia and search it.”
Write · folders.sh
Ask questions of a document, extract tables, get code advice
document.sh runs an AI agent on an indexed document, extract.sh runs structured extraction, and advisor.sh sends the files you name with a question to Nia for advice grounded in indexed sources.
Files · document.sh, extract.sh, advisor.sh
Read, write, move and delete files inside an indexed source
Lower-level file operations on Nia-side sources, including write, write-batch, delete, mkdir and mv.
Delete · fs.sh
Organize sources, share context between agents, analyze dependencies
contexts.sh saves and searches notes shared across agents. deps.sh reads a manifest such as package.json and can subscribe to documentation for its dependencies.
Write · categories.sh, contexts.sh, deps.sh
Sign up and mint an API key
signup creates an account, bootstrap-key and login-key mint a key, and SAVE_KEY=true writes it to ~/.config/nia/api_key.
Write · auth.sh

From the official docs

Permissions

High risk

The skill sends your questions, repos, and any folders or files you name to Nia's hosted service, and can connect your Slack, Drive and X accounts. Share only what you may, and use scoped tokens.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your files and code can be sent to Nia
folders.sh create reads the text files in a directory, skipping dotfiles, and posts their contents to Nia. create-db sends a database file. advisor.sh sends the files you name, and deps.sh uploads a manifest. Only point them at material you may share. github.com
It takes tokens for other accounts
slack.sh register-token passes a Slack bot token to Nia, google-drive.sh runs an OAuth flow for Drive, and x.sh create takes an X bearer token. Use scoped tokens, select only the channels or folders you need, and disconnect when done. github.com
Indexed docs are shared by default
sources.sh lists ADD_GLOBAL as true by default, and repos.sh says ADD_GLOBAL=false keeps a repository private. Set ADD_GLOBAL=false before indexing anything that is not public. github.com
It writes your key to disk when asked
auth.sh with SAVE_KEY=true writes the API key to ~/.config/nia/api_key, the same file the README suggests. The environment variable NIA_API_KEY takes precedence over that file. github.com
It can delete and rewrite Nia-side data
repos.sh delete, sources.sh delete and bulk-delete, and fs.sh write, delete, mkdir and mv change what Nia holds. They do not touch your local files. github.com
The README suggests a third-party setup command
The README lists npx nia-wizard@latest as a guided setup. That runs a package from npm; check it first if you prefer manual setup. github.com
It tells Claude to skip the web
SKILL.md says never to use web fetch or web search without checking Nia sources first, and not to skip to the web. That changes how Claude answers when this skill is active. github.com

Technical details

Turning on read-only	No read-only mode. Several scripts index, upload, write or delete.
Talks to	https://apigcp.trynia.ai/v2 (Nia API; the scripts read NIA_API_URL as an override)
Sign-in and keys	NIA_API_KEY from the environment or ~/.config/nia/api_key, sent as a Bearer token to Nia. auth.sh can save a key to that file.
Data retention	Indexed sources, uploaded folders and saved contexts are stored by Nia. SKILL.md does not describe retention.
Scopes	Runs shell scripts that send requests with your Nia API key to https://apigcp.trynia.ai/v2 Uploads text files from local folders you name, and database files, to Nia Can connect Slack, Google Drive and X accounts to Nia Can write or delete files inside Nia-side sources

Questions

What does the Nia skill do?

It gives Claude shell scripts for the Nia service. Claude can index repos, docs, papers, datasets, folders, Slack and Drive, then search and read them, run research jobs, and ask questions grounded in what is indexed.

How do I install Nia?

Use the install box at the top of this page, then get a Nia API key. The README lists signing up at trynia.ai, running npx nia-wizard@latest, or the bundled scripts/auth.sh commands.

Is it official, made by the Nia team?

Yes, as far as we can tell. The skill's homepage is trynia.ai, the nozomio-labs GitHub organization describes itself as "Makers of Nia", and the Nia docs site is titled "Welcome to Nia by Nozomio Labs". The skill README itself does not name its maker. The same organization has a separate nia-plugin repository for Claude Code; this page covers the nia-skill repo only.

Does Nia need an API key?

Yes. Set NIA_API_KEY or write the key to ~/.config/nia/api_key. The environment variable wins if both exist. SKILL.md marks Oracle, Tracer and deep research as Pro features.

What does Nia send out of my machine?

Queries, the repos and URLs you index, and any folder, database file, manifest or code file you name go to Nia's API at apigcp.trynia.ai. Slack, Drive and X connections give Nia access to those accounts.

Can I keep what I index private?

SKILL.md says to set ADD_GLOBAL=false to keep a repo private, and sources.sh lists ADD_GLOBAL as true by default. Local folders are described as private and user-scoped.

Is Nia safe to use?

It runs shell scripts that send content to a hosted third-party service and can hold tokens for your Slack, Drive and X accounts. Index public material first, use scoped tokens, and read the safety section before connecting anything.

Why does Claude refuse to use web search?

SKILL.md's first rule says never to use web fetch or web search without checking Nia sources first, and to use search.sh web or deep only for sources not in Nia. Remove or edit that rule if you want different behavior.

Can I use it in the Claude app?

Our advice: use Claude Code or another coding agent that can run shell scripts. This page has no Claude app upload because the skill needs curl and jq and runs local scripts.

Information

updated Nov 2, 2026

Repository: nozomio-labs/nia-skill

nozomio-labs/nia-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 10

README · github.com
nia SKILL.md · github.com
nia on skills.sh · skills.sh
scripts/sources.sh · github.com
nozomio-labs GitHub organization · github.com
Nia documentation · docs.trynia.ai
scripts/folders.sh · github.com
scripts/auth.sh · github.com
scripts/fs.sh · github.com
scripts/lib.sh · github.com