askill

> The package manager for AI agent skills.


🤖 For AI Agents (click to expand)

You are an AI agent helping a user with askill - a package manager for AI agent skills.

Quick Commands:
``bash


Install a published skill (@author/skill-name)

askill add @johndoe/awesome-tool -y

Install a skill

askill add owner/repo@skill-name -y

Install all skills from a repo

askill add owner/repo --all -y

List installed skills

askill list

Search for skills

askill find

Submit a GitHub skill URL for indexing

askill submit https://github.com/owner/repo

Login and publish your own skill

askill login --token ask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
askill publish

Run a skill command

askill run skill-name:command
`

Key Behaviors:
- Use -y flag to skip confirmation prompts
- Use -a to specify target agent (claude-code, cursor, opencode, etc.)
- Skills are installed to .agents/skills/ and symlinked to agent directories
- Check ~/.agents/.skill-lock.json for installed skill metadata

For Skill Development:
- Read docs/skill-spec.md for SKILL.md format
- Use askill init to create a new skill template
- Use askill validate to check SKILL.md syntax

Installed Skills:
After installation, read the skill's SKILL.md file for usage instructions. Skills are located at:
- Project: .agents/skills//SKILL.md
- Global: ~/.agents/skills//SKILL.md

---

askill is a universal package manager for AI agent skills. It enables agents to discover, install, and use skills across Claude Code, Codex, OpenCode, OpenClaw, Cursor, and 40+ other AI coding assistants.

Every skill on askill.sh is automatically reviewed by AI across 5 strict dimensions - Safety, Clarity, Reusability, Completeness, and Actionability - so risky or malicious skills are filtered out, and truly excellent skills rise to the top of the rankings.

Quick Start

`bash


Install

curl -fsSL https://askill.sh | sh

Install a published skill

askill add @johndoe/awesome-tool

Install a skill

askill add owner/repo@skill-name

Search for skills

askill find code review

List installed skills

askill list
`

Installation

$3

`bash
curl -fsSL https://askill.sh | sh
`

$3

`bash
npm install -g askill-cli
`

$3

`bash
npx askill-cli add owner/repo@skill-name
`

$3

`bash
askill --version
`

Usage

$3

`bash


From GitHub

askill add facebook/react@extract-errors

Browse and select from a repo

askill add anthropics/courses

Install all skills from a repo

askill add owner/repo --all

Non-interactive (for CI/agents)

askill add owner/repo@skill -y
`

$3

`bash
askill find memory
askill find code review
`

$3

`bash


List installed

askill list
askill list -g # global only

Check for updates

askill check

Update skills

askill update

Remove

askill remove skill-name

Update CLI itself

askill upgrade
`

$3

Skills can define executable commands:

`bash
askill run skill-name:command [args]

Example


askill run memory:save --key name --value "John"
`

Documentation

| Document | Description |
|----------|-------------|
| Getting Started | Quick start guide |
| CLI Reference | Complete command documentation |
| SKILL.md Specification | How to write skills |
| Publishing Guide | Publish your own skills |

Creating Skills

1. Create a SKILL.md file:

`markdown
---
name: my-skill
description: What this skill does
version: 1.0.0
---

My Skill

Instructions for the agent...
`

2. Test locally: askill add ./my-skill
3. Validate: askill validate
4. Submit for indexing: askill submit https://github.com//
5. Publish under your author scope: askill login then askill publish`

See Publishing Guide for details.

Contributing

We welcome contributions! See CONTRIBUTING.md for development setup and guidelines.

License

MIT License - see LICENSE for details.

---

Website: askill.sh | npm: askill-cli | GitHub: avibe-bot/askill