FAQ
September 18, 2026 · View on GitHub
Note
📘 Repo-Only Doc — last reviewed 2026-09-18
This document lives only in the repo. It is public-ready and self-contained.
FAQ
How do I install everything?
Use the generated complete-install blocks in generated/catalog.md (also on the wiki Plugin marketplace). Start with nanlabs-core for a smaller first install, then add group plugins. After Claude Code install, run /nanlabs-core:setup.
Is this only for Claude Code?
No. Production is the Agent Plugins roster (VS Code, Copilot, Cursor, ChatGPT/Codex, Kiro, Grok Bot, Hermes, OpenClaw, NanoClaw) plus Claude Code.
How does this differ from ulises-jeremias/agent-toolkit?
That project is a broad multi-tool toolkit (CLI, loops, many targets). This repo is NaNLABS L1.5 production distribution: no consumer CLI/loops compiler.
Do I need internal-workstation?
Not to install public plugins/skills. Yes for NaNLABS machine provisioning and secrets. See SCOPE.md.
Why no MCP tools after plugin install?
Install the group plugin that ships that server (nanlabs-design, nanlabs-forge, or nanlabs-integrations), reload, and complete OAuth. Skills-only (npx skills) does not register MCP. Slack may still need Slack’s own client plugin because Slack does not support Dynamic Client Registration.
If Cursor already lists ClickUp / Shortcut / Linear in ~/.cursor/mcp.json, plugin MCP can duplicate those servers — keep one of each.
Where is nanlabs-setup?
Merged into nanlabs-core (v0.3.0+). Use /nanlabs-core:setup.
Skills-only vs plugins vs packs?
Three different layouts:
| Path | Spec | What you get |
|---|---|---|
| Skills-only / domain packs | Agent Skills + npx skills | plugins/nanlabs-<group>/skills/<name>/SKILL.md. Domain packs are --skill aliases. |
| Agent Plugins v1 | Agent Plugins | Closed root plugin.json plus immediate plugins/<id>/skills/<name>/SKILL.md. Agents are not portable in v1. Official MCP is root mcp.json on design/forge/integrations. |
| Claude Code / Cursor plugins | Native marketplaces | Agents, commands, hooks, doctor. Native manifests live under .claude-plugin/ / .cursor-plugin/. |
Group packs (npx skills add nanlabs/agent-toolkit/plugins/nanlabs-delivery/skills) match group plugins. See PACKS.md. Portable vs native: AGENT_PLUGINS.md.
How do I share a skill?
Open a GitHub issue with the Propose skill template and a pull request. Maintainers approve; merge makes it installable. See CONTRIBUTION.md.
Cursor Agent CLI vs IDE?
Separate runtimes, equal product priority. Track evidence in CURSOR_CLI.md.