ask

command module

v0.2.0 Latest Latest Go to latest Published: Jan 15, 2026 License: MIT Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/yeasy/ask

Links

Open Source Insights

README ¶

ASK: Agent Skills Kit

Just ask, and your agent shall receive.

Quick Start · Commands · Sources · Docs

English | 中文

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

✨ Key Features

📦 Smart Package Management

Install, uninstall, update, and list skills with intuitive commands. Version locking via ask.lock ensures reproducible environments across teams.

🔍 Multi-Source Discovery

Search skills from multiple sources simultaneously — community topics, official repositories, and scientific domains. See which skills you already have installed.

⚡ Lightning Fast

Built with Go, compiling to a single static binary with zero runtime dependencies. Parallel search across all sources. Git sparse checkout for minimal downloads.

🔒 Version Locking

Pin specific versions with skill@v1.0 syntax. Track exact commits in ask.lock for reproducible installations.

📊 Progress Tracking

Real-time progress bars during installation and updates. Clear feedback on what's happening.

🚀 Quick Start

① Install ASK

# macOS (Homebrew)
brew tap yeasy/ask
brew install ask

# Or build from source
git clone https://github.com/yeasy/ask.git && cd ask
make build && mv ask /usr/local/bin/

② Initialize Your Project

ask init    # Creates ask.yaml in current directory

③ Search & Install Skills

ask skill search browser      # Search across all sources
ask skill install browser-use # Install a skill
ask skill list                # View installed skills

📋 Commands

Command	Description
`ask init`	Initialize project, create `ask.yaml`
Skill Management
`ask skill search <keyword>`	Search skills across all sources
`ask skill install <skill>`	Install a skill to `./skills/`
`ask skill install skill@v1.0`	Install specific version
`ask skill uninstall <skill>`	Remove a skill
`ask skill list`	List installed skills
`ask skill info <skill>`	Show skill details
`ask skill update [skill]`	Update skill(s) to latest
`ask skill outdated`	Check for updates
`ask skill create <name>`	Create new skill template
Repository Management
`ask repo list`	List skill sources
`ask repo add <url>`	Add custom source
`ask repo remove <name>`	Remove a source

🌐 Skill Sources

ASK searches these sources by default:

Source	Type	Description
Community	topic	GitHub repos with `agent-skill` topic
Anthropics	dir	Official anthropics/skills
MCP-Servers	dir	modelcontextprotocol/servers
Scientific	dir	Research skills from K-Dense-AI
Superpowers	dir	Core skills from obra/superpowers
OpenAI	dir	Codex skills from openai/skills

Add Custom Sources

# ask.yaml
repos:
  - name: my-team
    type: dir
    url: my-org/agent-skills/skills

📂 Project Structure

After using ASK, your project looks like:

my-agent/
├── ask.yaml          # Manifest file
├── ask.lock          # Version lock file
├── main.py           # Your agent code
└── .agent/
    └── skills/       # Managed skills
        ├── browser-use/
        └── web-surfer/

🛠 Development

make build     # Build binary
make test      # Run tests
make fmt       # Format code
make vet       # Check code
make install   # Install to $GOPATH/bin