> ## Documentation Index
> Fetch the complete documentation index at: https://docs.context.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Context.dev skill

> Install the Context.dev skill so your coding agent knows when and how to use the correct APIs.

The Context.dev skill teaches your coding agent how to use Context.dev without being told each time.

The skill file is hosted at [`docs.context.dev/skill.md`](https://docs.context.dev/skill.md).

Once installed, your agent will be able to:

* Look up brand information using name, domain, email, stock ticker, or ISIN
* Scrape websites and get markdown outputs
* Classify industries and transactions
* Integrate Context.dev APIs and SDKs into your application

## Prerequisites

* **A Context.dev API key.** Sign up at [context.dev/signup](https://context.dev/signup), copy the key from the [dashboard](https://context.dev/dashboard) (prefix `ctxt_secret_`), and export it in the shell your agent inherits so the skill can read it:

  ```bash theme={null}
  # Add to your shell profile or .envrc — never commit it.
  export CONTEXT_DEV_API_KEY="ctxt_secret_..."
  ```

  For a single project, drop it in `.env.local` and have the agent load that file before each run.
* **A supported agent.** Claude Code, Codex, Cursor, Windsurf, OpenCode, Gemini CLI, GitHub Copilot, and [50+ others](https://github.com/vercel-labs/skills#supported-agents) read skill files.
* **Node.js** to run the `npx skills` installer (or install manually with `curl`).

## Installation

### Method 1: Skills CLI (one command, every agent)

The skills CLI detects your agent and drops the skill in the directory that agent reads. One command covers every supported agent:

```bash theme={null}
npx skills add -g https://docs.context.dev/skill.md
```

Drop the `-g` to install into the current project instead of globally.

### Method 2: Manual install with `curl`

Pick your client below and run the matching `curl`. Use the project commands for an in-repo skill, or the global commands for a cross-project skill that lives in your home directory.

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    # Project
    mkdir -p .claude/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .claude/skills/context-dev/SKILL.md

    # Global (across all projects)
    mkdir -p ~/.claude/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o ~/.claude/skills/context-dev/SKILL.md
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    # Project
    mkdir -p .agents/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .agents/skills/context-dev/SKILL.md

    # Global
    mkdir -p ~/.codex/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o ~/.codex/skills/context-dev/SKILL.md
    ```
  </Tab>

  <Tab title="Cursor">
    ```bash theme={null}
    # Project
    mkdir -p .agents/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .agents/skills/context-dev/SKILL.md

    # Global
    mkdir -p ~/.cursor/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o ~/.cursor/skills/context-dev/SKILL.md
    ```
  </Tab>

  <Tab title="Windsurf">
    ```bash theme={null}
    # Project
    mkdir -p .windsurf/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .windsurf/skills/context-dev/SKILL.md

    # Global
    mkdir -p ~/.codeium/windsurf/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o ~/.codeium/windsurf/skills/context-dev/SKILL.md
    ```
  </Tab>

  <Tab title="OpenCode">
    ```bash theme={null}
    # Project
    mkdir -p .agents/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .agents/skills/context-dev/SKILL.md

    # Global
    mkdir -p ~/.config/opencode/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o ~/.config/opencode/skills/context-dev/SKILL.md
    ```
  </Tab>

  <Tab title="Any agent (.agents)">
    Codex, Cursor, OpenCode, Gemini CLI, GitHub Copilot, Cline, and other agents share the `.agents/skills/` directory:

    ```bash theme={null}
    mkdir -p .agents/skills/context-dev
    curl -fsSL https://docs.context.dev/skill.md -o .agents/skills/context-dev/SKILL.md
    ```
  </Tab>
</Tabs>

## Verify it loaded

Open a fresh agent session and ask:

> "Using Context.dev, what's the fastest, lightest-payload way to get just a brand's logos and colors for a domain?"

A correctly loaded skill answers with `GET /brand/retrieve-simplified` and notes it costs the same 10 credits as the full brand retrieve. If the agent invents an endpoint, the skill didn't load. Confirm the file exists at the path your agent reads and that nothing else is shadowing it.

## Next steps

<CardGroup cols={2}>
  <Card title="Agent Quickstart" icon="robot" href="/agent-quickstart">
    Pair the skill with a copyable agent prompt.
  </Card>

  <Card title="MCP server" icon="plug" href="/install-mcp">
    Add live API execution alongside the skill.
  </Card>

  <Card title="Get brand data" icon="address-card" href="/guides/get-brand-data">
    The core endpoint the skill teaches.
  </Card>

  <Card title="Introduction" icon="book" href="/introduction">
    What Context.dev returns and how responses are shaped.
  </Card>
</CardGroup>