Documentation
Everything you need to get started with SkillBazaar.
What are Agent Skills?
Agent Skills are reusable instruction files that configure how an AI agent behaves in a specific context. Think of them as a saved personality, workflow, or toolset that you can activate in any agent session with a single command.
A skill can be as simple as a writing style guide, or as complex as a multi-step engineering workflow. Once installed, you invoke it by name — e.g. "use the code-reviewer skill".
At its core, a skill is a folder containing a SKILL.md file. This file includes metadata (name and description, at minimum) and instructions that tell an agent how to perform a specific task. Skills can also bundle scripts, reference materials, templates, and other resources.
One skill, every agent
SKILL.md is a portable format — the same skill works across Claude, Codex, Cursor, and OpenClaw. Publish once and install into whichever agent you're using with a single command:
skillbazaar install my-skill --agent claude skillbazaar install my-skill --agent cursor
The CLI writes the skill to the right local directory for each agent (~/.claude/skills/, ~/.codex/skills/, ~/.cursor/skills/, or ~/.openclaw/skills/) so you can use the same skill no matter which agent you happen to be in today.
my-skill/ ├── SKILL.md # Required: metadata + instructions ├── scripts/ # Optional: executable code ├── references/ # Optional: documentation ├── assets/ # Optional: templates, resources └── ... # Any additional files or directories
Consistent outputs
Same quality every time, regardless of how you phrase the request.
Agent-agnostic
Write once, run in Claude, Codex, Cursor, OpenClaw, or any agent that reads SKILL.md.
Composable
Combine multiple skills in one conversation for complex workflows.
Publishing a Skill
There are two ways to publish — import straight from a GitHub repo on the web, or push from your terminal with the CLI. Every skill on SkillBazaar is public and free.
Create an account
Sign up for a free SkillBazaar account with email, Google, or GitHub. You'll need this to publish and manage your skills.
Open "Publish a Skill"
Hit the "+ Publish Skill" button in the top navigation to open the publish form.
Import from GitHub
Paste the URL of your skill folder on GitHub. SkillBazaar reads SKILL.md and its files live from GitHub — nothing is copied to our storage, so your repo stays the source of truth.
Review the details
Title and description are prefilled from your SKILL.md frontmatter. Pick a category and add any tags. Skills are agent-agnostic — the same skill installs into Claude, Codex, Cursor, and OpenClaw.
Run AI analysis (optional)
Add your Anthropic API key to have Claude review the skill for security & integrity and generate the listing. Passing both checks earns the Verified badge. Your key is sent once and never stored.
Publish
Your skill goes live immediately — browsable and installable from the Browse page. You can run AI analysis any time later from the skill's page to earn the Verified badge.
Verified Skills
A skill you install runs inside your agent with real reach — your files, your tools, your context. The Verified badge means a skill has passed SkillBazaar's review, so you can add it with confidence instead of auditing every line yourself.
Every skill goes through two layers of checks:
1 · Automated moderation
Runs on every publish. Anything that fails is rejected and never listed.
- • Valid
SKILL.mdstructure & metadata - • Spam & link-farming (URL density, shorteners)
- • Prompt-injection attempts (hidden instructions that try to hijack your agent)
- • Dangerous commands (e.g.
rm -rf /,curl | sh) - • Leaked secrets & credentials
- • Duplicate re-publishing
2 · AI security & integrity review
An optional Claude-powered analysis that earns the Verified badge. Passing both checks is required.
- Security — reviews the skill's files for anything that could harm you: data exfiltration, unsafe instructions, hidden or deceptive behavior.
- Integrity — confirms the skill actually does what it claims, with no surprises baked in.
Peace of mind, made visible
On any verified skill's page you'll see a green “Verified & secured” panel spelling out exactly which checks ran and when — full transparency, not a black box. Want to browse only trusted skills? Use the Verified Skills filter on the Browse page, or the Verified Skills row on the homepage.
Using the CLI
skillbazaar is a Node.js CLI that authenticates with your SkillBazaar account and writes skills directly to ~/.claude/skills/ (or ~/.codex/skills/), eliminating the manual copy-paste-upload cycle. Each skill is registered automatically in your agent config so it's ready to use immediately.
Install the CLI
npm install -g skillbazaar
Authentication
The first time you run any skillbazaar install command, you'll be prompted for your SkillBazaar email and password. Your credentials are cached in ~/.skillbazaar/config.json so subsequent runs sign in automatically.
Usage
Install a single skill
skillbazaar install <skill-slug> --agent <claude|codex|cursor|openclaw>Install one specific skill by its slug. You can find the slug in the skill's URL on SkillBazaar, e.g. skillbazaar install code-reviewer --agent claude.
Install your saved collection
skillbazaar install --saved --agent <claude|codex|cursor|openclaw>Installs every skill you've bookmarked on SkillBazaar in one go. Great for setting up a new machine with your curated toolkit.
Install all your published skills
skillbazaar install --mine --agent <claude|codex|cursor|openclaw>Installs all skills you've authored and published. Useful for syncing your own skills to a fresh environment.
Install a whole category
skillbazaar install --category "Real Estate" --agent <claude|codex|cursor|openclaw>Installs every live skill in a category in one go. The category name is case-insensitive, e.g. skillbazaar install --category "devops & cloud" --agent claude.
Install a whole tag
skillbazaar install --tag "research" --agent <claude|codex|cursor|openclaw>Installs every live skill with a given tag. Handy for grabbing a themed set in one go — copy the exact command from any tag on the Bundles page.
Install by author
skillbazaar install --author "anthropics" --agent <claude|codex|cursor|openclaw>Installs every live skill published from a given GitHub author/owner. Copy the exact command from any author on the Bundles page.
The --agent flag is required
Every skillbazaar install command — whether you're installing a single skill, your saved collection, a whole category, tag, or author bundle, or your published skills — must include --agent so the CLI knows which agent to write the skill files for.
skillbazaar install my-skill --agent claude
skillbazaar install --saved --agent codex
skillbazaar install --mine --agent claude
skillbazaar install --category "Real Estate" --agent claude
Accepted values: claude or codex.
Get your CLI auth key
The CLI authenticates with your email and a personal auth key issued from the Settings page. The shortcut skillbazaar link opens that page in your default browser:
skillbazaar link
On first run the CLI will prompt for both your email and the key, store them in ~/.skillbazaar/config.json, and refuse a key that doesn't belong to the email you entered.
Lost the key? Open Settings again and click Rotate to issue a fresh one — the old key is invalidated instantly.
To remove the stored credentials from a machine, run skillbazaar logout (deletes ~/.skillbazaar/config.json). To revoke the key everywhere, use Rotate in Settings.
Publish a skill from the CLI
skillbazaar publish publishes either from a local folder or straight from a GitHub URL. Both create the skill server-side and run the same moderation checks as the web form. CLI-published skills go live unverified — run the AI analysis from the skill's page later to earn the Verified badge.
From a local folder
Point at a folder containing a SKILL.md with a YAML frontmatter block (name: and description:). Published skills are agent-agnostic, so there's no agent to specify.
skillbazaar publish ~/.claude/skills/my-skill
skillbazaar publish ./my-skill
skillbazaar publish ./my-skill --tags coding,review
skillbazaar publish ./my-skill --category "Real Estate"
--category and --tags are optional — if you omit them, SkillBazaar picks a category and suggests tags from your skill's name and description.
From a GitHub URL
Publish a skill folder straight from GitHub — no local files needed. Pass the URL with --github, or just hand the GitHub URL to publish as the path. GitHub-sourced skills are read live from your repo and never copied to our storage.
skillbazaar publish --github github.com/user/repo/tree/main/my-skill
skillbazaar publish github.com/user/repo/tree/main/my-skill --tags coding,review