Skip to main content
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 (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

Verify it’s working:

​
Step 2: Authenticate

Or set the environment variable — it takes precedence over the stored key:
Check your auth status at any time:

​
Step 3: Browse available skills

This fetches the live catalogue from the agent-skills registry and prints each skill’s name, slug, and description. Search by keyword:
See the full details for a specific skill before installing:

​
Step 4: Install a skill

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:
To install only for a specific agent:
To install for all supported agents regardless of what’s detected:

​
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:
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

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

​
Create your own skill

Scaffold a new skill from a 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:
To share your skill with the community, submit a pull request to AIsa-team/agent-skills.

​
What’s next