API Designer
Jeffallan/claude-skills
Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.
Write or modify a NethSecurity Python RPCD API script or hook.
Install Ns API
$ npx skills add NethServer/nethsecurity --skill ns-api -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install NethServer/nethsecurity ns-api --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ns-api .claude/skills/ns-api && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .claude/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-apiType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add NethServer/nethsecurity --skill ns-api -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install NethServer/nethsecurity ns-api --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/ns-api .agents/skills/ns-api && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .agents/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NethServer/nethsecurity --skill ns-api -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install NethServer/nethsecurity ns-api --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/ns-api .cursor/skills/ns-api && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .cursor/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/NethServer/nethsecurity.git --path .agents/skills/ns-api--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add NethServer/nethsecurity --skill ns-api -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install NethServer/nethsecurity ns-api --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/ns-api .gemini/skills/ns-api && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .gemini/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install NethServer/nethsecurity ns-apiInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add NethServer/nethsecurity --skill ns-api -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/ns-api .github/skills/ns-api && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .github/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NethServer/nethsecurity --skill ns-api -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install NethServer/nethsecurity ns-api --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NethServer/nethsecurity.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/ns-api .opencode/skills/ns-api && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ns-api" agent skill from https://github.com/NethServer/nethsecurity/tree/main/.agents/skills/ns-api into .opencode/skills/ns-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ns-api", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
ns-api- GitHub stars
- 191
- Token cost
- ~2.8k tokens
- SKILL.md length
- 580 words
- Files
- 1
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Write or modify a NethSecurity Python RPCD API script or hook.
- Works in 2 steps: packages/ns-api/README.md —… → packages/ns-api/openapi.yml —…
- Tasks that involve OpenAPI specifications
- SKILL.md covers What I do, When to use me, File Structure and Protocol, plus 10 more sections
- Calls curl, ruff and jq
What it does
Ns API is an agent skill from NethServer/nethsecurity. Write or modify a NethSecurity Python RPCD API script or hook. Use when creating or updating ns. RPCD API endpoints, handling UCI configuration changes, managing pre/post-commit hooks, defining ACL permissions, and documenting methods in OpenAPI 3.1.0. Covers stdin/stdout JSON protocol, error handling, naming conventions, code style, and spec file updates.
Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Works with OpenCode and other Agent Skills-compatible tools. Requires Python 3.11+ and knowledge of OpenWrt rpcd framework.
It sits in Backend & APIs, covering OpenAPI specifications, REST APIs and Error handling. It works with OpenAPI, Python and Ruff. The repository describes itself as: NethSecurity image and build environment.
When your agent uses it
- Tasks that involve OpenAPI specifications
- Tasks that involve REST APIs
- Tasks that involve Error handling
Example prompts
- “/ns-api”
Requirements
- Python 3
- Node.js
- Compatibility (from SKILL.md): Works with OpenCode and other Agent Skills-compatible tools. Requires Python 3.11+ and knowledge of OpenWrt rpcd framework.
Workflow steps
2 steps, taken from the first numbered list in SKILL.md.
- packages/ns-api/README.md — Human-friendly narrative documentation. Update with method descriptions, parameters, and examples. This is the…
- packages/ns-api/openapi.yml — Machine-readable OpenAPI 3.1.0 specification. Add or update the method's path entry under paths. See OpenAPI…
What it can do on your machine
Read from SKILL.md and the folder at commit a22e7f9. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
curlruffjqnpx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use curl and npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Works with OpenCode and other Agent Skills-compatible tools. Requires Python 3.11+ and knowledge of OpenWrt rpcd framework.
From compatibility in the SKILL.md frontmatter.
Context cost
Ns API loads about 2.8k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 580 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 580 words (~2,784 tokens).
“Use this skill when you are:”
- name
- ns-api
- compatibility
- Works with OpenCode and other Agent Skills-compatible tools. Requires Python 3.11+ and knowledge of OpenWrt rpcd framework.
- metadata.domain
- nethsecurity-apis
- metadata.type
- api-development
Files
Just SKILL.md in .agents/skills/ns-api of NethServer/nethsecurity.
Open the folder on GitHubat commit a22e7f9
Compare with similar skills
Ns API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Ns API this skillNethServer/nethsecurity | 191 | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| API DesignerJeffallan/claude-skills | 12k | 2 repos | ~2k | Automated safety check: Pass | MIT | |
| Dotnet Webapidotnet/skills | 5.6k | 2 repos | ~5.5k | Automated safety check: Pass | MIT | |
| FastAPI ExpertJeffallan/claude-skills | 12k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Python Fastapi Patternsaiskillstore/marketplace | 430 | 1 repos | ~1.3k | Automated safety check: Notes | None | |
| API Endpointslatitude-dev/latitude-llm | 4.7k | — | ~6.5k | Automated safety check: Pass | MIT |
Similar skills
- Official
Dotnet Webapi
dotnet/skills
Guides creation and modification of ASP.NET Core Web API endpoints with correct HTTP semantics, OpenAPI metadata, and error handling.
FastAPI Expert
Jeffallan/claude-skills
Builds async Python APIs with FastAPI and Pydantic V2, covering endpoints, JWT authentication, async SQLAlchemy, WebSockets and pytest checks against the OpenAPI docs.
Python Fastapi Patterns
aiskillstore/marketplace
FastAPI web framework patterns. An agent skill from aiskillstore/marketplace.
API Endpoints
latitude-dev/latitude-llm
Adding or changing API operations in @repo/operations. An agent skill from latitude-dev/latitude-llm.
REST API Expert
cin12211/orca-q
REST API design and development expert specializing in endpoint design, HTTP semantics, versioning, error handling, pagination, and OpenAPI documentation.
More from NethServer/nethsecurity
Openwrt Package Update
NethServer/nethsecurity
A skill your agent uses when updating any forked OpenWrt package in a NethSecurity workspace from the upstream openwrt/packages feed.
Netifyd
NethServer/nethsecurity
Work with the Netify Agent (netifyd) DPI daemon on NethSecurity — its configuration graph, processor/sink plugins, flow-actions rules, criteria expressions, address groups, telemetry records and CLI.
Create Issue
NethServer/nethsecurity
Turn messy raw material — coworker chat excerpts, support discussions, log snippets, debugging findings, CI failures — into a well-formed GitHub issue on the NethServer/nethsecurity tracker via the…
Openwrt Package
NethServer/nethsecurity
Create or modify an OpenWrt ns- package including Makefile, config fragments, and upstream patches.
Python Nethsecurity
NethServer/nethsecurity
Write or modify Python scripts for NethSecurity packages. An agent skill from NethServer/nethsecurity.
Related
Categories
Questions about Ns API
What does Ns API do?
Write or modify a NethSecurity Python RPCD API script or hook. Ns API is an agent skill from NethServer/nethsecurity. Write or modify a NethSecurity Python RPCD API script or hook.
When should I use Ns API?
Ns API fits situations like: tasks that involve OpenAPI specifications; tasks that involve REST APIs; tasks that involve Error handling.
How do I install Ns API in Claude Code?
Run `npx skills add NethServer/nethsecurity --skill ns-api -a claude-code`. Or copy the skill folder (.agents/skills/ns-api in NethServer/nethsecurity) into .claude/skills/ns-api in your project. Claude Code loads it when a task matches its description.
How do I install Ns API in Codex?
Run `npx skills add NethServer/nethsecurity --skill ns-api -a codex`. Or copy the skill folder (.agents/skills/ns-api in NethServer/nethsecurity) into .agents/skills/ns-api in your project. Codex loads it when a task matches its description.
Can I use Ns API in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NethServer/nethsecurity --skill ns-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ns-api, .gemini/skills/ns-api, .github/skills/ns-api and .opencode/skills/ns-api in your project.
What does Ns API need to run?
Going by SKILL.md and its folder, Ns API needs the command-line tools its instructions call (curl, ruff, jq and npx). Our summary lists: Python 3; Node.js. Compatibility (from SKILL.md): Works with OpenCode and other Agent Skills-compatible tools. Requires Python 3.11+ and knowledge of OpenWrt rpcd framework..
Does Ns API access the network?
SKILL.md contains no URLs. Its commands use curl and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Ns API safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Ns API use?
Ns API has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Ns API use?
About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Ns API?
Skills that share tags, products or a category with Ns API: API Designer (Jeffallan/claude-skills, 12k stars), Dotnet Webapi (dotnet/skills, 5.6k stars), FastAPI Expert (Jeffallan/claude-skills, 12k stars) and Python Fastapi Patterns (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Ns API?
NethServer (a GitHub organization) maintains it in NethServer/nethsecurity, which has 191 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 6, 2026.
Source: NethServer/nethsecurity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.