ask

README

ASK: Agent Skills Kit

The Missing Package Manager for AI Agents

Just ask, and your agent shall receive.

English | 中文

---

🚀 Quick Start • ✨ Features • 📋 Commands • 📚 Documentation

---

ASK (Agent Skills Kit) is the package manager for AI Agent capabilities. Just like brew manages macOS packages or npm manages Node.js dependencies, ask helps you discover, install, and lock skills for your AI agents (Claude, Cursor, Codex, etc.).

graph LR
    User[User/Agent] -->|ask skill search| Sources[GitHub/Community]
    Sources -->|Discover| Skills{Skills}
    User -->|ask skill install| Skills
    Skills -->|Download & Lock| Agent[.agent/skills/]
    
    style User fill:#4a9eff,color:white
    style Sources fill:#ff6b6b,color:white
    style Agent fill:#90ee90,color:black

✨ Key Features

Feature	Description
📦 Smart Management	Install, update, and remove skills with ease. Includes ask.lock for reproducible builds.
🔍 Multi-Source	Unified search across GitHub and official repos (Anthropic, OpenAI, MATLAB).
🤖 Multi-Agent	Auto-detects and installs for Claude (.claude/), Cursor (.cursor/), Codex (.codex/), and more.
⚡ Blazing Fast	Written in Go. Parallel downloads, sparse checkouts, and zero runtime dependencies.
🔌 Offline Mode	Full offline support with --offline. Perfect for air-gapped or secure environments.
🌍 Global & Local	Manage project-specific skills (.agent/skills) or user-wide tools (~/.ask/skills).

🚀 Quick Start

1. Install

Homebrew (macOS/Linux):

brew tap yeasy/ask
brew install ask

Go Install:

go install github.com/yeasy/ask@latest

2. Initialize

Enter your project directory and run:

ask init

This creates an ask.yaml configuration file.

3. Use

# Search for skills
ask skill search browser

# Install a skill (by name or repo)
ask skill install browser-use
ask skill install superpowers

# Install specific version
ask skill install browser-use@v1.0.0

# Install for specific agent
ask skill install browser-use --agent claude

📋 Commands

Skill Management

Command	Description
ask skill search <keyword>	Search across all sources
ask skill install <name>	Install skill(s)
ask skill list	List installed skills
ask skill uninstall <name>	Remove a skill
ask skill update	Update skills to latest version
ask skill outdated	Check for newer versions

Repository Management

Command	Description
ask repo list	Show configured repositories
ask repo add <url>	Add a custom skill source

🌐 Skill Sources

ASK comes pre-configured with trusted sources:

Source	Description
Anthropic	Official anthropics/skills
Community	Top-rated community skills (GitHub agent-skill topic)
Composio	ComposioHQ/awesome-claude-skills collection
MATLAB	Official matlab/skills
OpenAI	Official openai/skills
Superpowers	obra/superpowers core library
SkillHub	SkillHub.club
Vercel	vercel-labs/agent-skills AI SDK skills

📂 Installation Layout

Default structure after installation:

my-project/
├── ask.yaml          # Project config
├── ask.lock          # Lockfile (commit hashes)
└── .agent/           
    └── skills/       # Default install location
        ├── browser-use/
        └── web-surfer/

Agent-Specific Paths:

• Claude: .claude/skills/
• Cursor: .cursor/skills/
• Codex: .codex/skills/

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

📄 License

MIT License. See LICENSE for details.