agent-toolkit

NaNLABS skills, agents, and plugins — install once, use in Claude Code, Cursor, Copilot, and the Agent Plugins roster.

Wiki · Install plugins · Add a skill · Contribute

Important

This repo is the public product (L1.5): skills, agents, plugins, official MCP. NaNLABS laptops are provisioned by private nanlabs/internal-workstation (L1). Employees run nan-ai-enable after chezmoi. You do not need the workstation to install plugins from here. How do I use this? The GitHub Wiki is the shareable guide: install plugins, day-to-day use, add a skill, testing.

Install everything

Copy the block for your client. Then reload and complete MCP OAuth when prompted.

Claude Code — marketplace add, then every group plugin

/plugin marketplace add nanlabs/agent-toolkit
/plugin install nanlabs-core@nanlabs-agent-toolkit
/plugin install nanlabs-data@nanlabs-agent-toolkit
/plugin install nanlabs-delivery@nanlabs-agent-toolkit
/plugin install nanlabs-design@nanlabs-agent-toolkit
/plugin install nanlabs-forge@nanlabs-agent-toolkit
/plugin install nanlabs-integrations@nanlabs-agent-toolkit
/plugin install nanlabs-ops@nanlabs-agent-toolkit
/plugin install nanlabs-tooling@nanlabs-agent-toolkit
/plugin install nanlabs-workflow@nanlabs-agent-toolkit
/plugin install nanlabs-agents@nanlabs-agent-toolkit
/nanlabs-core:setup

GitHub Copilot CLI

copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-core
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-data
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-delivery
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-design
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-forge
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-integrations
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-ops
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-tooling
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-workflow
copilot plugin install nanlabs/agent-toolkit:plugins/nanlabs-agents

Cursor IDE — local plugins (or Team Marketplace import)

mkdir -p ~/.cursor/plugins/local
REPO=/path/to/agent-toolkit
ln -sfn "$REPO/plugins/nanlabs-core" ~/.cursor/plugins/local/nanlabs-core
ln -sfn "$REPO/plugins/nanlabs-data" ~/.cursor/plugins/local/nanlabs-data
ln -sfn "$REPO/plugins/nanlabs-delivery" ~/.cursor/plugins/local/nanlabs-delivery
ln -sfn "$REPO/plugins/nanlabs-design" ~/.cursor/plugins/local/nanlabs-design
ln -sfn "$REPO/plugins/nanlabs-forge" ~/.cursor/plugins/local/nanlabs-forge
ln -sfn "$REPO/plugins/nanlabs-integrations" ~/.cursor/plugins/local/nanlabs-integrations
ln -sfn "$REPO/plugins/nanlabs-ops" ~/.cursor/plugins/local/nanlabs-ops
ln -sfn "$REPO/plugins/nanlabs-tooling" ~/.cursor/plugins/local/nanlabs-tooling
ln -sfn "$REPO/plugins/nanlabs-workflow" ~/.cursor/plugins/local/nanlabs-workflow
ln -sfn "$REPO/plugins/nanlabs-agents" ~/.cursor/plugins/local/nanlabs-agents

Reload the window after linking.

Skills-only — Agent Skills CLI, no plugins / MCP / agents

npx skills add nanlabs/agent-toolkit -g

Group or domain pack: docs/PACKS.md.

VS Code · Codex · Kiro · rest of the Agent Plugins roster

Client	How
VS Code	"chat.plugins.marketplaces": ["nanlabs/agent-toolkit"] then install each nanlabs-*
ChatGPT / Codex	codex plugin marketplace add nanlabs/agent-toolkit then install from the Plugins Directory
Kiro	Powers → Import from folder → plugins/nanlabs-<group> (not the repo root)
Grok / Hermes / OpenClaw / NanoClaw	Point the client at plugins/nanlabs-<group>/ (plugin.json + skills/)
Cursor Agent CLI	agent plugin marketplace add https://github.com/nanlabs/agent-toolkit then --plugin-dir — docs/CURSOR_CLI.md

Full matrix: docs/ADOPTION.md.

Start with nanlabs-core if you want a smaller first install. Run /nanlabs-core:setup after Claude Code install.

Catalog

Tables below are generated from products/plugins.yaml, catalogs/mcp-catalog.yaml, and catalogs/skills-layout.json. Do not hand-edit them — run python3 scripts/gen-surfaces.py. Full dump: docs/generated/catalog.md.

Plugins

Plugin	Version	Skills	MCP	Role
nanlabs-core	0.4.1	7	—	Recommended first install. Setup doctor + /nanlabs-core:setup.
nanlabs-data	0.1.0	2	—	dbt and Snowflake validation skills
nanlabs-delivery	0.1.0	19	—	PRD, TRD, ADR, work items, assessments, and delivery process
nanlabs-design	0.2.0	6	figma	Figma MCP and UI/UX intelligence (not a full designer workflow)
nanlabs-forge	0.2.0	4	github, gitlab	GitHub and GitLab CLI automation plus official GitHub and GitLab MCP
nanlabs-integrations	0.2.0	4	atlassian, clickup, linear, notion, shortcut, slack	ClickUp, Slack, Linear, Shortcut, Notion, and Atlassian (Jira/Confluence) MCP plus CLI skills
nanlabs-ops	0.2.0	4	—	Workstation triage, presentations ops, skill contribution, and HOL Guard local runtime safety
nanlabs-tooling	0.1.0	2	—	Playwright CLI and Jupyter notebook scaffolding
nanlabs-workflow	0.1.0	2	—	Client delivery workflows and bootstrap
nanlabs-agents	0.2.1	—	—	Optional. Full agent roster.

Official MCP

Authenticate in the client. No tokens in the plugin. Slack may need workspace admin approval.

Server	Plugin	Official URL	Notes
atlassian	nanlabs-integrations	https://mcp.atlassian.com/v2/mcp	Covers Jira, Confluence, Jira Service Management, Bitbucket, Loom. Official Atlassian Rovo MCP v2. One server covers Jira and Confluence.
clickup	nanlabs-integrations	https://mcp.clickup.com/mcp	Official ClickUp hosted MCP. OAuth only; API tokens are not supported.
figma	nanlabs-design	https://mcp.figma.com/mcp	Official Figma remote MCP. OAuth. Figma allowlists MCP clients.
github	nanlabs-forge	https://api.githubcopilot.com/mcp/	Official GitHub hosted MCP. OAuth in VS Code / Copilot; some Cursor setups still prompt for a PAT in user MCP config, not in this plugin.
gitlab	nanlabs-forge	https://gitlab.com/api/v4/mcp	Official GitLab.com MCP. Self-managed instances use https://<host>/api/v4/mcp in user config instead.
linear	nanlabs-integrations	https://mcp.linear.app/mcp	Official Linear hosted MCP. OAuth 2.1. SSE at /sse is deprecated.
notion	nanlabs-integrations	https://mcp.notion.com/mcp	Official Notion hosted MCP. OAuth. Open-source notion-mcp-server is unmaintained.
shortcut	nanlabs-integrations	https://mcp.shortcut.com/mcp	Official Shortcut hosted MCP. OAuth; no API token.
slack	nanlabs-integrations	https://mcp.slack.com/mcp	Official Slack hosted MCP. OAuth. Slack does not support Dynamic Client Registration; workspace admin approval is required. Slack's own client plugins may still be needed for client-id-bound OAuth.

How it fits

Layer	Repo	Owns
L1	nanlabs/internal-workstation (private)	Machine, secrets, chezmoi
L1.5	this repository (public)	Skills, agents, plugins, MCP

Docs

Start at the GitHub Wiki (synced from docs/wiki/). Long-form repo docs stay under docs/.

Need	Go to
Install plugins	Wiki: Installation
Use skills and MCP	Wiki: Using · Official MCP
Add a skill / open a PR	Wiki: Add a skill · Wiki: Contributing
Run the same checks as CI	Wiki: Testing
Plugin / MCP / skill tables	Wiki: Plugin marketplace · Generated catalog
Install matrix by client	Adoption
In / out of scope	Wiki: Scope · SCOPE.md
Common questions	Wiki: FAQ
Packs	PACKS
Release / pin / rollback	Wiki: Lifecycle · RELEASE

Quality bar

python3 scripts/gen-surfaces.py --check
python3 scripts/validate-manifests.py
python3 scripts/validate-mcp.py
python3 scripts/validate-skill-inventory.py
pre-commit run --all-files

CI on main: Validate, MegaLinter, wiki sync. See CONTRIBUTING.md.

License

MIT · SECURITY.md · docs/PUBLIC_CONTENT_POLICY.md

_{Brand: NaNLABS Octonan from public nanlabs/.github. README artwork: static/.}