Back to Documentation

Getting Started

Install your first skill in under a minute

Prerequisites

  • Node.js 18+ - Skills CLI requires Node.js. Check with node --version
  • An AI coding agent - Claude Code, Cursor, Windsurf, Cline, or any agent that can read project files
1

Install a Skill

Navigate to your project directory and install a skill. Let's start with the Supabase skill:

npx skills add supabase/agent-skills

This downloads the Supabase skill and adds it to your project. No npm install required - npx runs it directly.

2

Check Installation

Verify the skill was installed:

npx skills list

You should see output like:

Installed skills:
  supabase/agent-skills (v2.1.0)
    └── Database, auth, and realtime patterns
3

Project Structure

Skills are stored in a .skills/ directory in your project:

your-project/
├── .skills/
│   ├── skills.json          # Tracks installed skills
│   └── supabase/
│       └── agent-skills/
│           └── SKILL.md     # The skill instructions
├── src/
├── package.json
└── ...

The .skills/ directory should be committed to version control so your team shares the same skills.

4

Use with Your AI Agent

That's it! Your AI coding agent will automatically read the skill files when working on your project. Try asking it to:

  • +"Set up Supabase authentication in my Next.js app"
  • +"Create a real-time subscription for my chat feature"
  • +"Write a secure RLS policy for my users table"

The AI will use the Supabase skill's knowledge to write idiomatic, secure code following best practices.

Common Commands

Install multiple skills at once

npx skills add supabase/agent-skills stripe/agent-skills vercel/agent-skills

Update all skills to latest versions

npx skills update

Remove a skill

npx skills remove supabase/agent-skills

Search for skills

npx skills search database

Next Steps