Skip to main content

​
Agent Skills Quickstart

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

npm install -g @aisa-one/cli
Verify it’s working: 
aisa --version

​
Step 2: Authenticate

aisa login --key YOUR_AISA_API_KEY
Or set the environment variable — it takes precedence over the stored key: 
export AISA_API_KEY="YOUR_AISA_API_KEY"
Check your auth status at any time: 
aisa whoami

​
Step 3: Browse available skills

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

​
Step 4: Install a skill

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: 
✓ ~/.claude/skills/ (claude)
✓ ~/.cursor/skills/ (cursor)
Skill 'search' installed to 2 agent(s)
To install only for a specific agent: 
aisa skills install search --agent claude
To install for all supported agents regardless of what’s detected: 
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: 
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

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

# 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: 
# 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: 
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.

​
What’s next