Skip to content
/ ask Public

The missing Package Manager for Agents Skills: search, query and install/uninstall in seconds!

License

Notifications You must be signed in to change notification settings

yeasy/ask

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

114 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ASK: Agent Skills Kit for Enterprise AI

ASK Logo

The Missing Package Manager for Agent Skills

Just ask, the agents are ready!

Release License Stars Go Report Card Go Version

English | δΈ­ζ–‡


πŸš€ Quick Start β€’ ✨ Features β€’ πŸ“‹ Commands β€’ πŸ“š Documentation


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

✨ 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, etc.). You can add more skill sources.
πŸ€– Agent Agnostic Works with any agent. Auto-detects configuration for Claude, Cursor, Codex, and adapts to your custom agents.
⚑ 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).
πŸ›‘οΈ Security Audit Built-in security scanner checks skills for secrets, dangerous commands, and malware using entropy analysis.
πŸ–₯️ Desktop & Web Beautiful UI available as ask serve web server or native desktop app via Wails.

πŸ–₯️ Web UI & Desktop App

ASK Skills Manager

ASK provides a beautiful web interface for skill discovery and management β€” available as a web server (ask serve) or a native desktop app.

Feature Description
πŸ“Š Visual Dashboard Overview of installed skills, repos, and system stats
πŸ” Skill Browser Search, filter, and install skills with rich metadata
πŸ“¦ Repository Manager Add and sync skill sources from GitHub
πŸ›‘οΈ Security Audit View generated safety reports

Quick Start

# Web Server
ask serve

# Desktop App (requires Wails CLI)
wails build && ./build/bin/ask-desktop

πŸ“– Explore the Web UI Documentation β†’

1. Install

Homebrew (macOS/Linux):

brew tap yeasy/tap
brew install yeasy/tap/ask              # CLI version
brew install --cask yeasy/tap/ask-desktop  # Desktop App (macOS only)

Note

macOS Users: When opening ask-desktop for the first time, if you see an "unidentified developer" warning, please go to System Settings > Privacy & Security, and click "Open Anyway" in the Security section.

Go Install:

go install github.com/yeasy/ask@latest

Binary / Manual Install (Windows / Linux / Desktop): Download the latest pre-compiled binary or Desktop App for your system from Releases.

2. Initialize

Enter your project directory and run:

ask init

This creates an ask.yaml configuration file.

3. Use

# Search for skills
ask search mcp

# Install a skill (by name or repo, `ask add` is an alias for `ask install`)
ask install anthropics/mcp-builder
ask install superpowers

# Install specific version
ask install mcp-builder@v1.0.0

# Install for specific agent
ask install mcp-builder --agent claude
ask install mcp-builder --agent claude cursor

# Security Check
ask check .
ask check anthropics/mcp-builder -o report.html

# Start Web UI
ask serve

πŸ“‹ 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
ask skill check <path> Security scan (Secrets, Dangerous Commands)

Repository Management

Command Description
ask repo list Show configured repositories
ask repo add <url> Add a custom skill source (run ask repo sync after to download)
ask repo sync Download/update repos to local cache (~/.ask/repos)

System Commands

Command Description
ask doctor Diagnose and report on ASK health (config, skills, cache, system)
ask serve Start web UI for visual skill management

🌐 Skill Sources

ASK comes pre-configured with trusted sources:

Source Description
Anthropic Official anthropics/skills
Community Top-rated community skills (GitHub agent-skill and agent-skills topics)
Composio ComposioHQ/awesome-claude-skills collection
OpenAI Official openai/skills
Vercel vercel-labs/agent-skills AI SDK skills

Optional Repositories

For specific needs, you can add these additional sources:

Repository Command to Add Description
Scientific ask repo add K-Dense-AI/claude-scientific-skills Data science & research skills
MATLAB ask repo add matlab/skills Official MATLAB integration
Superpowers ask repo add obra/superpowers Full dev workflow with sub-agents
Planning ask repo add OthmanAdi/planning-with-files File-based persistent planning
UI/UX Pro ask repo add nextlevelbuilder/ui-ux-pro-max-skill 57 UI styles, 95 color schemes
NotebookLM ask repo add PleasePrompto/notebooklm-skill Auto-upload to NotebookLM
AI DrawIO ask repo add GBSOSS/ai-drawio Flowchart & diagram generation
PPT Skills ask repo add op7418/NanoBanana-PPT-Skills Dynamic PPT generation

πŸ—οΈ Architecture & Layout

For detailed architecture diagrams and installation layout, see Architecture Guide.

🐞 Debugging

To see detailed operational logs (scanning, updating, searching), set ASK_LOG=debug:

export ASK_LOG=debug
ask skill install browser-use

⌨️ Shell Completion

ASK supports intelligent tab completion for skill names, repository names, and agent flags.

Setup (one-time):

# Bash
ask completion bash > $(brew --prefix)/etc/bash_completion.d/ask

# Zsh
ask completion zsh > "${fpath[1]}/_ask"

# Fish
ask completion fish > ~/.config/fish/completions/ask.fish

Features:

  • ask skill install <TAB> - Complete from cached skills
  • ask skill uninstall <TAB> - Complete from installed skills
  • ask repo sync <TAB> - Complete from configured repositories
  • ask install --agent <TAB> - Complete agent names (claude, cursor, codex, etc.)

πŸ“Š Security Audit Reports

See detailed security audit reports generated for top skill repositories:

🀝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

πŸ“„ License

MIT License. See LICENSE for details.

About

The missing Package Manager for Agents Skills: search, query and install/uninstall in seconds!

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published