nsgo · nsgo-dev, .agent — Claude Code skill: what it does, how to install
nsgo is a Claude Code skill that finds first-party NSGo docs for building, testing, and shipping apps. It also locates component APIs and target status.
Apache-2.0 ★ 686 updated 2026-11-17
npx skills add nsgo-dev/nsgo --skill nsgo -a claude-codeWhat nsgo does
The nsgo skill locates NSGo documentation from the repository and uses the llms.txt index to find Markdown pages. It covers the project basics, app build and run steps, tests, shipping, component APIs, and the state of a target.
A page is read through the .md URL listed in the index; the complete document set is available at https://nsgo.dev/llms-full.txt. Repository examples include examples/gallery, examples/hello, and examples/tsx. Engine changes are documented in AGENTS.md and ARCHITECTURE.md.
NSGo has no stable API yet, so the skill points to the current checkout when a signature matters. Source checks use git grep or go list; terminal-based page retrieval uses curl and requires access to nsgo.dev.
What it helps with
- locate the first-party NSGo documentation page
- work out how to build and run an app
- check a component API against the current commit
- verify a target's feature state
- find the repository rules for changing NSGo
Example prompts for the agent
- Find the NSGo documentation for building and running this app.
- Show the component API and compare its signature with the current checkout.
- Check the docs for the current state of this target.
How to install nsgo
1Skills CLI (Vercel)
npx skills add nsgo-dev/nsgo --skill nsgo -a claude-code2Manually: put the files in place
~/.claude/skills/nsgo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/nsgo/
1Skills CLI (Vercel)
npx skills add nsgo-dev/nsgo --skill nsgo -a codex2Manually: put the files in place
.agents/skills/nsgo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nsgo-dev/nsgo --skill nsgo -a cursor2Manually: put the files in place
.cursor/skills/nsgo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nsgo-dev/nsgo .agent/skills/nsgo2Manually: put the files in place
.github/skills/nsgo/SKILL.md1Skills CLI (Vercel)
npx skills add nsgo-dev/nsgo --skill nsgo -a gemini-cli2Platform CLI
gemini skills install https://github.com/nsgo-dev/nsgo --path .agent/skills/nsgoManually: put the files in place
.devin/skills/nsgo/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about nsgo
How do I install nsgo in Claude Code?
Run npx skills add nsgo-dev/nsgo --skill nsgo -a claude-code, then check ~/.claude/skills/nsgo/SKILL.md.
What does nsgo do?
It searches the llms.txt documentation index for NSGo Markdown pages covering app development, component APIs, and target status.
What does nsgo need to work?
It needs access to nsgo.dev. Terminal retrieval uses curl, and source signatures can be checked with git grep or go list.
Source text
SKILL.md · Apache-2.0
---
name: nsgo
description: Find the NSGo docs while working in this repository. Use when you need what NSGo is, how to build, run, test or ship an app with it, a component's API, or a target's state, and want the first-party page rather than a guess. Holds the index of every page as Markdown, which llms.txt beside it lists.
---
# NSGo docs
`llms.txt` beside this file is <https://nsgo.dev/llms.txt>: the index of every
page of NSGo's documentation as Markdown, one line a page with its URL and a
sentence on what it covers.
To read a page, take its URL from the index and add nothing: the `.md` link is
already the page's Markdown.
```sh
curl -sS https://nsgo.dev/docs/components.md
```
`https://nsgo.dev/llms-full.txt` holds every page at once, which is large:
fetch it only when a task spans many pages.
## Before relying on a signature
NSGo is early, with no stable API. The docs describe the latest release, and
this checkout may be ahead of or behind it, so read the source for the commit
at hand instead of guessing from a signature:
```sh
git grep -n 'func Name' core/ # in this checkout
go list -m -f '{{.Dir}}' github.com/nsgo-dev/nsgo # an installed module
```
`examples/gallery` demonstrates every component, `examples/hello` is the
smallest app and `examples/tsx` a TSX one. Copy their structure rather than
inventing one. `docs/roadmap.md` says what is missing, by target: check it
before assuming a feature exists everywhere.
## This repository
Rules for changing NSGo itself are in `AGENTS.md`, and how the engine is put
together in `ARCHITECTURE.md`; neither is on the website. `skills/nsgo/` is the
skill apps install with `bunx skills add nsgo-dev/nsgo`, which is for writing
apps, not for changing the engine.
© nsgo-dev · Apache-2.0 · nsgo-dev/nsgo
Similar skills
All skills for Writing and docs →nsgo by other authors comes first.