← Back to Skills Marketplace
2589
Downloads
0
Stars
3
Active Installs
4
Versions
Install in OpenClaw
/install nia
Description
Index and search code repositories, documentation, research papers, HuggingFace datasets, local folders, and packages with Nia AI. Includes Oracle autonomous research, dependency analysis, context sharing, and code advisor.
Usage Guidance
This skill appears to implement the advertised Nia indexing/search features, but pay attention before installing or running it:
- The scripts expect a Nia API key stored at ~/.config/nia/api_key and will read it automatically; the registry metadata does not declare this — verify you trust trynia.ai before adding your key.\n
- Many commands (folders create/sync, deps upload, advisor with files, from-db, etc.) will read local files or accept DB connection strings and send their contents to the remote API (https://apigcp.trynia.ai/v2). Do not index or upload secrets, private keys, credentials, or sensitive directories (home, /.ssh, etc.).\n
- The skill lets you share conversation contexts across agents — that can leak confidential chat history if used without limits.\n
- If you plan to let an autonomous agent invoke this skill, restrict what the agent can do: avoid granting it access to sensitive local folders or database credentials, or disable autonomous invocation for this skill in your agent policy if possible.\n
- Recommended steps before use: (1) Confirm the homepage and API host are the official provider you expect; (2) create a dedicated, limited-scope API key on trynia.ai (if supported) rather than using a broad key; (3) review and avoid running folder/index commands on sensitive paths; (4) prefer manual invocation and inspect commands before running.\n
- The main metadata omission (undeclared config path / credential) is an incoherence — ask the publisher to declare required credentials and config paths in the registry entry before trusting automated workflows.
Capability Analysis
Type: OpenClaw Skill
Name: nia
Version: 1.0.3
The skill is classified as suspicious due to several high-risk capabilities that, while aligned with its stated purpose of indexing and searching, could be easily abused for data exfiltration. Specifically, `scripts/folders.sh` contains functions (`_scan_folder`, `cmd_from_db`, `cmd_preview_db`) that allow reading arbitrary local text files and executing arbitrary SQL queries against accessible databases, then uploading the content/results to the remote API endpoint `https://apigcp.trynia.ai/v2`. While there is no clear evidence of intentional malicious behavior or prompt injection attempts in the `SKILL.md` to subvert the agent, these broad file and database access permissions represent a significant security risk if the agent were to be compromised or misused.
Capability Assessment
Purpose & Capability
The scripts (repos, sources, search, oracle, tracer, folders, advisor, deps, contexts, etc.) implement indexing/searching of repos, docs, papers, datasets, local folders, dependency analysis and an 'Oracle' research flow — which matches the skill name and description.
Instruction Scope
Runtime instructions and provided scripts will read local files and directories (folders.sh _scan_folder) and can upload their full contents, accept DB connection strings and run DB previews/uploads, and save/share conversation contexts. These behaviors are consistent with the feature set but expand the scope to potentially exfiltrate arbitrary local data to https://apigcp.trynia.ai/v2 if misused or invoked without careful limits; SKILL.md does not prominently warn about sensitive-data risks.
Install Mechanism
No install spec or remote download; this is an instruction+script bundle included in the skill. No installers or remote archives are fetched by the package itself (lower install risk).
Credentials
The registry metadata claims no required env/config, but SKILL.md + scripts require an API key stored in ~/.config/nia/api_key (lib.sh reads it on source). That credential/config-path requirement is not declared in metadata (and 'required config paths' is empty), which is an inconsistency. The scripts also accept optional DB connection strings, files to upload, and many optional env vars for behavior — these are plausible for the stated purpose but increase sensitivity because secrets and local data may be sent to the provider.
Persistence & Privilege
The skill is not always-included, does not request elevated platform privileges, and does not modify other skills or system-wide settings. Note: lib.sh auto-initializes auth on source which causes the scripts to read the API key file when any script is run.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nia - After installation, invoke the skill by name or use
/nia - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Nia 1.0.3 — Major script refactor and new unified commands.
- Consolidated 28 individual scripts into 13 unified scripts with subcommands for simpler usage.
- Added new top-level scripts: `sources.sh`, `repos.sh`, `papers.sh`, `datasets.sh`, `search.sh`, `oracle.sh`, `tracer.sh`, and more.
- New functionality: category and context management, dependency analysis, local folders, and code advisor scripts.
- Updated SKILL.md for new usage patterns, environment variables, and script arguments.
- Most commands now support flexible identifiers (UUID, display name, or URL).
- Deprecated commands and endpoints are now removed for a cleaner interface.
v1.0.2
- Added support for the `unified` search mode to `search-query.sh`, enabling simultaneous search across repositories and data sources.
- Enhanced `search-universal.sh` to allow including HuggingFace datasets by passing `true` as the third argument (excluded by default).
- Updated documentation in SKILL.md to describe the new `search_mode` in `search-query.sh` and expanded usage notes for both key search scripts.
- No breaking changes; workflows remain the same for existing functionality.
v1.0.1
- Added 7 new scripts for enhanced data source, package, search, and Oracle research job operations.
- New scripts include: sources-ls.sh (list source directories), sources-read.sh, package-read.sh, search-query.sh, oracle-job.sh, oracle-job-status.sh, and oracle-jobs-list.sh.
- Expanded documentation to cover new endpoints and usage examples, including clearer API references and identifier flexibility.
- Introduced "Oracle Jobs API" for managing asynchronous AI research jobs.
- Improved search functionality with targeted and universal query scripts.
- Added a usage summary script for tracking API consumption.
v1.0.0
- Initial release of the Nia skill.
- Direct API access to Nia for indexing and searching code repositories, documentation, research papers, and HuggingFace datasets.
- Provides setup instructions, workflow guidance, and example scripts for all core functions.
- Supports deterministic research workflows prioritizing indexed sources for accurate AI context.
- Includes scripts and guidance for repository, documentation, research paper, and dataset management.
- Offers API reference and usage examples for flexible integration.
Metadata
Frequently Asked Questions
What is Nia?
Index and search code repositories, documentation, research papers, HuggingFace datasets, local folders, and packages with Nia AI. Includes Oracle autonomous research, dependency analysis, context sharing, and code advisor. It is an AI Agent Skill for Claude Code / OpenClaw, with 2589 downloads so far.
How do I install Nia?
Run "/install nia" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nia free?
Yes, Nia is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Nia support?
Nia is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nia?
It is built and maintained by arlanrakh (@arlanrakh); the current version is v1.0.3.
More Skills