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

# Agent Skills Quickstart

> Install the AIsa CLI, authenticate with your API key, and add reusable agent skills to Claude Code, Cursor, Codex, OpenClaw, and other supported agents.

This guide takes you from zero to a working skill in about five minutes.

## Prerequisites

* Node.js 18 or later
* An AIsa account and API key — [sign up at aisa.one](https://console.aisa.one/) (new accounts start with \$2 free credit)
* At least one supported AI coding agent installed: Claude Code, Cursor, GitHub Copilot, Windsurf, Codex, Gemini CLI, or OpenClaw

***

## Step 1: Install the AIsa CLI

```bash theme={null}
npm install -g @aisa-one/cli
```

Verify it's working:

```bash theme={null}
aisa --version
```

***

## Step 2: Authenticate

```bash theme={null}
aisa login --key YOUR_AISA_API_KEY
```

Or set the environment variable — it takes precedence over the stored key:

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
```

Check your auth status at any time:

```bash theme={null}
aisa whoami
```

***

## Step 3: Browse available skills

```bash theme={null}
aisa skills list
```

This fetches the live catalogue from the [agent-skills](https://github.com/AIsa-team/agent-skills) registry and prints each skill's name, slug, and description.

Search by keyword:

```bash theme={null}
aisa skills search "finance"
aisa skills search "search"
```

See the full details for a specific skill before installing:

```bash theme={null}
aisa skills show market
```

***

## Step 4: Install a skill

```bash theme={null}
aisa skills install search
```

The CLI automatically detects every supported agent on your machine and writes the skill to each agent's skills directory. You'll see a confirmation line per agent:

```text theme={null}
✓ ~/.claude/skills/ (claude)
✓ ~/.cursor/skills/ (cursor)
Skill 'search' installed to 2 agent(s)
```

To install only for a specific agent:

```bash theme={null}
aisa skills install search --agent claude
```

To install for all supported agents regardless of what's detected:

```bash theme={null}
aisa skills install search --agent all
```

***

## Step 5: Use the skill

Open a **new session** in your agent (skills are loaded at session start, not mid-session). Then ask it to do something the skill handles:

```text theme={null}
Search the web for the latest news on AI agent frameworks and summarise the top three stories.
```

The agent reads the `search` skill description, loads the full `SKILL.md` instructions, and calls the AIsa search API using your key.

***

## Step 6: Install multiple skills

```bash theme={null}
aisa skills install market
aisa skills install twitter
aisa skills install media-gen
```

Once multiple skills are installed, your agent can use whichever is appropriate for any given task — without you specifying which skill to use.

***

## Managing installed skills

```bash theme={null}
# List skills available in the registry
aisa skills list

# Remove a skill from all agent directories
aisa skills remove market

# Remove from a specific agent only
aisa skills remove market --agent cursor
```

***

## Create your own skill

Scaffold a new skill from a template:

```bash theme={null}
# Default blank template
aisa skills init my-skill

# Start from a specific template
aisa skills init my-skill --template finance    # finance template
aisa skills init my-skill --template search     # search template
aisa skills init my-skill --template llm        # LLM gateway template
aisa skills init my-skill --template twitter    # Twitter template
aisa skills init my-skill --template video      # video generation template
```

This creates a `my-skill/` folder with a pre-filled `SKILL.md`. Edit the `name`, `description`, and body to describe your capability. Then install it like any other skill:

```bash theme={null}
aisa skills install ./my-skill    # install from local path
```

To share your skill with the community, submit a pull request to [AIsa-team/agent-skills](https://github.com/AIsa-team/agent-skills).

***

## What's next

* [Agent Skills](/agent-skills) — full catalogue with descriptions and GitHub links
* [Standards](/agent-skills/standards) — how SKILL.md files work and how to author your own
* [Agent Skills vs custom skills](/guides/learn/agent-skills-vs-tools) — when to use a registry skill vs. building your own
* Questions? [contact us](mailto:developer@aisa.one)