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

# Claude Code Skill

> Automated job search skill for Claude Code

# Claude Code Skill

The Nico skill for Claude Code enables Claude to search job boards, parse postings, and add proposed jobs to your Nico board — all from a conversation.

## What it does

When you invoke the skill, Claude will:

1. Search Nico's job index for openings matching your criteria (and fall back to external job boards for anything not yet in Nico)
2. For each job found:
   * Check if it's already in your Nico board
   * Pull the posting's details
   * Add it as a **proposed** application
3. Report a summary of what was added

## Installation

### Get the skill

Clone the [`nico-jobagent/nico-skills`](https://github.com/nico-jobagent/nico-skills) repository:

```bash theme={null}
git clone https://github.com/nico-jobagent/nico-skills.git
```

The paths below refer to your local clone of this repository.

### Quick install (recommended)

Run the interactive setup script from the repository root:

```bash theme={null}
cd nico-skills
./setup.sh
```

`setup.sh` does both halves of setup for you:

* **Installs the skill** — detects your installed AI agents (Claude Code, OpenClaw, Cursor, GitHub Copilot) and symlinks the skill into each.
* **Configures credentials** — prompts for your `NICO_API_KEY` (and optional `NICO_API_URL`) and writes them to your shell profile.

Open a new terminal (or `source` your profile) afterward so the variables take effect. If you run `setup.sh`, you can skip the manual install and [configuration](#configuration) steps below.

### Install manually

Prefer to wire it up yourself? Install the skill for your tool:

#### As a Claude Code plugin

```bash theme={null}
claude --plugin-dir /path/to/nico-skills
```

#### As a user skill

```bash theme={null}
ln -s /path/to/nico-skills/skills/nico-jobagent ~/.claude/skills/nico-jobagent
```

#### Other AI coding assistants

The skill also works with OpenClaw, Cursor, GitHub Copilot, and any agent that supports SKILL.md files. Symlink the skill directory to the appropriate location for your tool.

## Configuration

<Note>
  If you ran `setup.sh`, your credentials are already configured — skip this section.
</Note>

Set the required environment variable:

```bash theme={null}
export NICO_API_KEY="your-api-key-here"
```

Optionally set the API URL (defaults to `api.nico-jobagent.com`; the scheme is optional):

```bash theme={null}
export NICO_API_URL="api.nico-jobagent.com"
```

See [API Keys](/integrations/api-keys) for how to create an API key.

## Usage

Once installed, invoke the skill in Claude Code:

```
/nico-jobagent
```

Then tell Claude what kind of jobs you're looking for:

> "Find remote product manager positions in Europe paying over 80k EUR"

Claude will search, parse, and add matching jobs to your board. You'll see them as **Proposed** applications on your kanban board, ready for your review.

## Under the hood

The skill uses the [Nico CLI tool](/integrations/cli) (`nico_client.py`) — a zero-dependency Python 3 script. No pip install or virtual environment needed.

## Compatible tools

| Tool           | Installation                     |
| -------------- | -------------------------------- |
| Claude Code    | Plugin dir or user skill symlink |
| OpenClaw       | Symlink to skills directory      |
| Cursor         | Symlink to skills directory      |
| GitHub Copilot | Symlink to skills directory      |