Getting Started

Install curated AI skills into your coding assistant in seconds.

What are skills?

Skills are markdown files that tell your AI coding assistant how to behave in specific situations. They encode best practices, patterns, and conventions for frameworks, languages, and domains — so your assistant gives better suggestions out of the box, without needing constant prompting.

Skills are installed into .agents/skills/ — a shared directory that 8 universal agents read natively. Claude Code and other dedicated models get an additional symlink in their own directory so every agent always stays in sync.

Supported AI assistants

11 agents supported across two tiers. Install once — all agents stay in sync automatically.

Universal — read from .agents/skills/ natively, no extra setup

  • Amp
  • Cline
  • Codex
  • Cursor
  • Gemini CLI
  • GitHub Copilot
  • Kimi Code CLI
  • OpenCode

Dedicated — also get a symlink in their own directory

Assistant Directory --model ID
Claude Code .claude/skills/ claude
Antigravity .agent/skills/ antigravity
OpenClaw skills/ openclaw

Commands

$ npx ai-agents-skills add

Interactive mode — prompts you to choose skills, models, and presets.

$ npx ai-agents-skills add --skill react

Install a specific skill directly, no prompts.

$ npx ai-agents-skills add --skill react --skill typescript

Install multiple skills at once.

$ npx ai-agents-skills add --preset astro-template

Install a project preset (curated bundle of skills).

$ npx ai-agents-skills list

List all skills currently installed and which agents are covered.

$ npx ai-agents-skills remove

Remove installed skills interactively.

$ npx ai-agents-skills sync

Update installed skills to the latest versions or add support for new dedicated models.

Skill types

Behavioral

Code style, conventions, and general AI behavior rules.

 Universal

Cross-language patterns applicable to any project.

 Language

Language-specific patterns — TypeScript, Python, Go, etc.

 Framework

Framework guidance — React, Astro, Next.js, Express, etc.

 Library

Library usage patterns — Tailwind, Zod, Prisma, etc.

 Tooling

Tooling workflows — Jest, ESLint, Docker, CI/CD, etc.

 Domain

Domain knowledge — Clean Architecture, DDD, A11y, etc.

AGENTS.md

AGENTS.md is a project-level briefing file placed at the root of your repository. It tells your AI assistant which skills are available, when to trigger each one, how the project is structured, and what workflows and policies to follow.

Think of it as a persistent system prompt for your entire project — written once, applied to every conversation. Your AI reads it on every session and uses it to stay consistent with your team's standards without needing to be reminded.

AGENTS.md contains

  • Skills reference — which skill to use for each type of task
  • Project structure — how the codebase is organized
  • Workflows — step-by-step processes for common tasks
  • Policies — code style, typing rules, and team conventions

Presets

A preset is a curated starter bundle for a specific project type. It installs a collection of relevant skills and generates a ready-to-use AGENTS.md tailored to that stack — so your AI assistant is fully configured from day one.

For example, an astro-template preset would install the Astro, TypeScript, Tailwind CSS, and accessibility skills, then drop an AGENTS.md pre-configured for that stack at your project root.

⚙

Presets are supported by the CLI today via --preset <id> — the catalog is actively being developed and will be published soon.

Ready to explore all skills?

Browse Skill Catalog