Documentation

Overview

Agent skills are reusable capabilities for AI agents. They provide procedural knowledge that helps agents accomplish specific tasks more effectively. Each skill typically includes a SKILL.md file plus optional scripts and templates.

SkillsAuth is a marketplace for verified agent skills. We index skills from public GitHub repositories, run security and quality checks, and give you one place to browse, search, and install them. All skills remain the property of their authors; we do not claim ownership.

Using the platform

Use the Browse skills page to search and filter by category, publisher, or keyword. Open any skill to see its description, scan status, and install options. You can download the SKILL.md file or the full skill directory as a zip. For a short walkthrough, see Getting started.

CLI

The skillsauth CLI lets you search, list, and install verified skills from the terminal. It is published on npm and is open for public use.

Installation

Install globally or run with npx:

npm install -g skillsauth
# or run without installing
npx skillsauth <command>

Verify with: skillsauth --version

Quick start

# Search for skills
skillsauth search "react"

# List skills in a repository
skillsauth list owner/repo

# Install (interactive)
skillsauth add owner/repo

# Install with auto-confirm or globally
skillsauth add owner/repo --yes
skillsauth add owner/repo --global

# See installed skills
skillsauth installed

# Update or remove
skillsauth update
skillsauth remove <slug>

Commands

• add <owner/repo> [skill-name] — Install skills from a repository. Options: -g, --global, -y, --yes.

  skillsauth add owner/repo
  skillsauth add owner/repo skill-name --yes --global

• list <owner/repo> — List all verified skills in a repository.

  skillsauth list owner/repo

• search <query> — Search the SkillsAuth marketplace. Option: -l, --limit <n> (default 10).

  skillsauth search "typescript"
  skillsauth search "api" --limit 20

• installed — Show installed skills. Option: -g, --global.

  skillsauth installed
  skillsauth installed --global

• update — Update all installed skills. Option: -g, --global.

  skillsauth update

• remove <slug> — Remove an installed skill. Options: -g, --global, -y, --yes.

  skillsauth remove <slug>

Supported AI agents

The CLI installs to the appropriate directory for each agent:

Environment variables

Lockfile

The CLI maintains a lockfile to track installed skills: local .skillsai-lock.json (project root), global ~/.skillsai/lock.json.

Manual installation

If you prefer not to use the CLI, download a skill from the marketplace and place the files in the right directory for your agent:

• Antigravity: ~/.gemini/antigravity/skills/ (global) or .agent/skills/ (project)
• Claude Code: ~/.claude/skills/ (global) or .claude/skills/ (project)
• Codex: ~/.agents/skills/ (global) or .agents/skills/ (project)
• Cursor: ~/.cursor/skills/ (global) or .cursor/skills/ (project)
• Gemini CLI: ~/.gemini/skills/ (global) or .gemini/skills/ (project)
• GitHub Copilot: ~/.copilot/skills/ (global) or .github/skills/ (project)
• OpenCode: ~/.config/opencode/skills/ (global) or .opencode/skills/ (project)
• Windsurf: ~/.codeium/windsurf/skills/ (global) or .windsurf/skills/ (project)

Security

Skills on SkillsAuth are scanned with tools such as mcp-scan and Semgrep and may be verified with services like VirusTotal. Skills that fail security checks are quarantined and cannot be installed via the platform or CLI.

We do our best to maintain a safe ecosystem, but we cannot guarantee the quality or security of every skill. We encourage you to review skills before installing and use your own judgment.