Official AI agent skills from Notte — teach any Agent Skills-compatible coding agent (Claude Code, Cursor, Goose, OpenHands, Gemini CLI, OpenAI Codex, Kiro, VS Code, Bitterbot, and 30+ others) how to drive a real browser
→ Read more at: Landing • Console • Docs • X • LinkedIn
This repository ships the official AI agent skill for notte.cc, letting your coding agent drive a real cloud or local browser. The bundled skill exposes observe/click/fill/scrape primitives, AI browser agents, and the ability to deploy browser automation as a scheduled, API-callable Function.
# Add the Notte skills marketplace
/plugin marketplace add nottelabs/notte-skills
# Install the Notte plugin
/plugin install notte
# Optional: provider cost comparison and migration to Notte
/plugin install notte-migrateInstall from the Cursor Marketplace:
- Open Cursor Settings > Plugins
- Search for "Notte"
- Install the plugin
The Cursor plugin includes the Notte browser skill and best-practice rules.
Codex installs the same plugins from this repository:
# Register this repository as a plugin marketplace
codex plugin marketplace add nottelabs/notte-skills
# Install the Notte plugin (skills + the hosted Notte MCP servers)
codex plugin add notte@notte
# Optional: provider cost comparison and migration to Notte
codex plugin add notte-migrate@notteThen start a new Codex session. Run /plugins inside Codex to browse, enable, or
disable them interactively, and codex mcp list to confirm the hosted MCP
servers registered.
Codex namespaces plugin skills by plugin name, so invoke them as
$notte:notte-browser, $notte:notte-functions-build,
$notte:notte-functions-doctor, and $notte-migrate:migrate-to-notte.
Installs the skills only — no MCP servers, no plugin manifest:
# Interactive: pick which skills to install
npx skills add nottelabs/notte-skills
# Or target one client explicitly
npx skills add nottelabs/notte-skills --agent codexSkills land in .agents/skills/ in the current project, or in the client's
global skills directory with --global.
Copy the individual skill folders — not the plugin folder — into your client's
skills directory. Each skill directory must sit directly under the scan path so
that its SKILL.md is one level deep.
git clone https://github.com/nottelabs/notte-skills.git
# Claude Code
cp -r notte-skills/plugins/notte/skills/* ~/.claude/skills/
# Codex (or any client reading the shared ~/.agents/skills path)
mkdir -p ~/.agents/skills
cp -r notte-skills/plugins/notte/skills/* ~/.agents/skills/Installing the notte plugin (via Claude Code or Codex — not npx skills add)
also registers two hosted MCP servers. The skills are written against the CLI
and prefer it; these are complementary:
| Server | URL | What it does |
|---|---|---|
notte-browser |
https://api.notte.cc/mcp |
The Notte browser API over MCP, for clients that cannot run shell commands |
anything-api |
https://anything.notte.cc/mcp |
Marketplace of ready-made Notte Functions (search, spec, run) plus build, which turns a plain-English description into a deployed Function |
anything-api's search needs no authentication, so it is worth checking before
building a scraper from scratch — someone may already have published one for
your target site. Browse it at anything.notte.cc/marketplace.
build and run authenticate over OAuth (your client prompts) or with
Authorization: Bearer $NOTTE_API_KEY.
Both servers authenticate independently of notte auth login — a working CLI
session does not imply a working MCP connection. Run codex mcp list (Codex) or
/mcp (Claude Code) to confirm they registered.
Before using this skill, ensure the agent can run the notte CLI and authenticate with a Notte API key.
Install the CLI:
brew tap nottelabs/notte-cli https://github.com/nottelabs/notte-cli.git
brew install notteOr install with Go:
go install github.com/nottelabs/notte-cli/cmd/notte@latestAuthenticate:
# Recommended for local development
notte auth login
# Or for CI/CD and non-interactive agents
export NOTTE_API_KEY=...
notte auth statusOnce installed, your coding agent will automatically know how to use Notte.
Everything you need to drive a real browser with Notte.
| Skill | Description |
|---|---|
| notte-browser | Manage browser sessions, accounts, and deploy Notte Functions from the command line |
| notte-functions-build | Explore a site once and deploy it as a reusable, parameterized Notte Function (a scheduled, API-callable endpoint). Explore once, run at scale forever |
| notte-functions-doctor | Diagnose and repair a broken or failing Notte Function - recover its contract, find what changed on the site, verify a fix in isolation, and promote it behind a confirmation gate |
Install this one only if you are coming from another browser automation provider.
| Skill | Description |
|---|---|
| migrate-to-notte | Cost-compare another provider against Notte from a codebase, telemetry, or invoice, then migrate to Notte with a measured baseline, a safe proof, and a reversible rollout |
Ask your agent, invoking the skill the way your client does — /notte-browser
in Claude Code, $notte:notte-browser in Codex (or $notte-browser when
installed with npx skills add):
"/notte-browser Go to news.ycombinator.com and give me the top 5 posts as JSON with title, url, and points."
A skill-aware agent should (1) load notte-browser/SKILL.md into its context, and (2) produce a working notte CLI invocation that scrapes the page and returns the result in the requested shape.
If the agent proceeds without consulting the skill, check: the skill files live at the expected scan path, the folder names match the name: field in each SKILL.md frontmatter, and your client supports Agent Skills (see the list).
Skill content is licensed under the MIT License. Notte itself (the SDK referenced by these skills) is licensed under SSPL-1.0 — see github.com/nottelabs/notte.
Copyright © 2026 Notte Labs, Inc.