notte-cli

Notte Skills - Official AI agent skills for browser automation

---

What is Notte Skills?

This repository ships the official AI agent skills for notte.cc, letting your coding agent drive a real cloud or local browser. The bundled skills expose observe/click/fill/scrape primitives, an agent runtime that takes a natural-language task and returns structured Pydantic output, and the ability to deploy any browser automation as a scheduled, API-callable Function.

Installation

Claude Code

# Add the Notte skills marketplace
/plugin marketplace add nottelabs/notte-skills

# Install the CLI skill
/plugin install notte-cli

# Install the SDK skills
/plugin install notte-sdks

Cursor

Install from the Cursor Marketplace:

1. Open Cursor Settings > Plugins
2. Search for "Notte"
3. Install the plugin

The Cursor plugin includes all skills, an MCP server for cloud browser management, and best-practice rules.

Any agent

npx skills add nottelabs/notte-skills

Manual installation

git clone https://github.com/nottelabs/notte-skills.git
cp -r notte-skills/plugins/notte-cli ~/.claude/skills/
cp -r notte-skills/plugins/notte-sdks ~/.claude/skills/

Prerequisites

Before using these skills, ensure you have:

1. Python 3.11+ in whatever environment the agent shells into.

2. A Notte API key for hosted mode (recommended):

   pip install notte
   export NOTTE_API_KEY=...   # from https://console.notte.cc
   

   Or local mode (no API key, runs Chromium on the user's machine):

   pip install notte
   patchright install --with-deps chromium
   

3. If you use notte.Agent(...) in local mode, an LLM provider key such as OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, or an OpenRouter key.

Once installed, your coding agent will automatically know how to use Notte.

Available skills

notte-cli

CLI skills for using Notte CLI commands.

Skill	Description
notte-browser	Manage browser sessions, accounts, and deploy Notte Functions from the command line

notte-sdks

SDK skills for building browser automation and agent workflows with the Notte Python SDK.

Skill	Description
notte	Drive a real browser from Python: observe / click / fill / scrape, run agent tasks against natural-language goals, return Pydantic-typed output, and deploy automations as serverless Notte Functions

Verify it's wired up

Ask your agent:

"/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).

Documentation

• Notte documentation
• Console / API keys
• Python SDK source
• Agent Skills specification

Support

• GitHub Issues

License