https://github.com/yeasy/ask

The most powerful Package Manager for Agents Skills: search, query and install/uninstall in seconds!
https://github.com/yeasy/ask
agent agent-skill agent-skills ai
Last synced: 3 months ago
JSON representation
The most powerful Package Manager for Agents Skills: search, query and install/uninstall in seconds!
Host: GitHub
URL: https://github.com/yeasy/ask
Owner: yeasy
License: mit
Created: 2026-01-15T06:57:52.000Z (6 months ago)
Default Branch: main
Last Pushed: 2026-02-13T01:34:38.000Z (5 months ago)
Last Synced: 2026-02-13T10:47:35.895Z (5 months ago)
Topics: agent, agent-skill, agent-skills, ai
Language: HTML
Homepage:
Size: 25.6 MB
Stars: 11
Watchers: 0
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project

README

          # ASK: Agent Skills Kit



  



One command. Every agent.




  Install once — works with Claude, Cursor, Codex, Copilot, Windsurf, Gemini, OpenClaw, and 12 more.





  

  

  

  

  





  English | 中文



---



  💡 Why ASK •

  🚀 Quick Start •

  ✨ Features •

  📋 Commands •

  📚 Documentation



---

## 💡 Why ASK

You find a great skill on Claude, but you also use Cursor.

You set up rules in Cursor, but your teammate uses Copilot.

You want to audit third-party skills, but there's no standard tool.

**ASK solves this.** One install, every agent stays in sync — with version locking, security scanning, and offline support built in.

```

$ ask install browser-use

✓ Installed browser-use

  Synced to: Claude   (.claude/skills/)

             Cursor   (.cursor/skills/)

             Codex    (.codex/skills/)

```

## ✨ Key Features

| Feature | Description |

| :--- | :--- |

| **🤖 19 Agents, One CLI** | Install once, auto-sync to Claude, Cursor, Codex, Copilot, Windsurf, Gemini CLI, OpenClaw, and 12 more. No vendor lock-in. |

| **📦 Version Locking** | `ask.lock` pins exact commits for reproducible builds. `ask lock-install` for CI/CD like `npm ci`. |

| **🛡️ Security Scanner** | 26+ built-in rules check for secrets, dangerous commands, and malware. SARIF output for GitHub Code Scanning. |

| **🔍 Curated Registry** | Search across the [official registry](https://github.com/yeasy/awesome-agent-skills), GitHub repos, and community sources. |

| **⚡ Blazing Fast** | Written in Go. Parallel downloads, sparse checkouts, and zero runtime dependencies. |

| **🔌 Offline & Enterprise** | Full offline mode, private repo support, source whitelists, and HTML audit reports. |

| **🌎 Global & Local** | Project-specific skills (`.agent/skills`) or user-wide tools (`~/.ask/skills`). |

| **🖥️ Desktop & Web** | Beautiful UI via `ask serve` web server or native desktop app via [Wails](https://wails.io). |

## 🖥️ Web UI & Desktop App



  



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 |

### Launch

```bash

# Web Server

ask serve

# Desktop App (requires Wails CLI)

wails build && ./build/bin/ask-desktop

```

📖 [Explore the Web UI Documentation →](docs/web-ui.md)

## 🚀 Quick Start

### 1. Install

**Homebrew (macOS/Linux):**

```bash

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:**

```bash

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](https://github.com/yeasy/ask/releases).

### 2. Initialize

Enter your project directory and run:

```bash

ask init

```

This creates an `ask.yaml` configuration file.

### 3. Use

```bash

# 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 a skill from a root-level repository

ask install op7418/Youtube-clipper-skill

# 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

# Restore skills from ask.lock or ask.yaml (if no arguments provided)

ask install

# Start Web UI

ask serve

# Install skills from a specific repository

ask skill install --repo anthropics pdf

# Install all skills from a specific repository

ask skill install --repo anthropics

```

## 📋 Commands

### Skill Management

| Command | Description |

| :--- | :--- |

| `ask skill search ` | Search across all sources |

| `ask skill install ` | Install skill(s) (aliases: `add`, `i`) |

| `ask skill list` | List installed skills |

| `ask skill uninstall ` | Remove a skill |

| `ask skill update` | Update skills to latest version |

| `ask skill outdated` | Check for newer versions |

| `ask skill info ` | Show detailed skill information |

| `ask skill check ` | Security scan + SKILL.md format validation |

| `ask skill score ` | Compute trust score for a skill |

| `ask skill test ` | Run validation checks on a skill |

| `ask skill prompt [paths]` | Generate XML for agent system prompts |

| `ask skill create ` | Create a new skill from template |

| `ask skill publish ` | Validate and prepare skill for publishing |

### Repository Management

| Command | Description |

| :--- | :--- |

| `ask repo list` | Show configured repositories |

| `ask repo add ` | Add a custom skill source (use `--sync` or run `ask repo sync` after to download) |

| `ask repo remove ` | Remove a repository |

| `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 |

| `ask audit` | Generate security audit report for installed skills |

| `ask lock-install` | Install exact versions from `ask.lock` (like `npm ci`) |

| `ask init` | Initialize ASK project configuration |

| `ask benchmark` | Run performance benchmarks on configured repos |

| `ask quickstart` | Install recommended skill packs |

| `ask version` | Show current version |

## 🌐 Skill Sources

ASK comes pre-configured with trusted sources:

| Source | Description |

| :--- | :--- |

| **Anthropic** | Official [anthropics/skills](https://github.com/anthropics/skills) |

| **Community** | Top-rated community skills (GitHub `agent-skill` and `agent-skills` topics) |

| **Composio** | [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) collection |

| **OpenAI** | Official [openai/skills](https://github.com/openai/skills) |

| **Vercel** | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) AI SDK skills |

| **OpenClaw** | [openclaw/openclaw](https://github.com/openclaw/openclaw/tree/main/skills) Built-in skills from OpenClaw |

### 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 |

| **Antigravity** | `ask repo add sickn33/antigravity-awesome-skills` | Collection of 600+ skills for Claude Code & Cursor |

## 🏗️ Architecture & Layout

For detailed architecture diagrams and installation layout, see [Architecture Guide](docs/architecture.md).

## 🐞 Debugging

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

```bash

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

# 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 ` - Complete from cached skills

- `ask skill uninstall ` - Complete from installed skills  

- `ask repo sync ` - Complete from configured repositories

- `ask install --agent ` - Complete agent names (claude, cursor, codex, etc.)

## 📊 Security Audit Reports











See detailed security audit reports generated for top skill repositories:

- [🛡️ Anthropic Security Audit Report](reports/anthropics.html)

- [🛡️ OpenAI Security Audit Report](reports/openai.html)

- [🛡️ Composio Security Audit Report](reports/composio.html)

- [🛡️ Vercel Security Audit Report](reports/vercel.html)

- [🛡️ Superpowers Security Audit Report](reports/superpowers.html)

## 🆚 Comparison

|  | ASK | Claude Native | Cursor Rules |

| :--- | :---: | :---: | :---: |

| **Multi-agent support** | ✅ 19 agents | Claude only | Cursor only |

| **Version locking** | ✅ `ask.lock` | ❌ | ❌ |

| **Security scanning** | ✅ 26+ rules | ❌ | ❌ |

| **Offline mode** | ✅ | ❌ | ❌ |

| **Team sharing** | ✅ lock file | ❌ | ❌ |

| **Private repos / Enterprise** | ✅ | ❌ | ❌ |

| **CLI interface** | ✅ | ❌ | ❌ |

| **Curated registry** | ✅ | ❌ | ❌ |

## 🤝 Contributing

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## 📄 License

MIT License. See [LICENSE](LICENSE) for details.
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/yeasy/ask

Awesome Lists containing this project

README

One command. Every agent.
