---
slug: "skilless-ai"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/BrikerMan/skilless.ai@main/README.md"
repo: "https://github.com/BrikerMan/skilless.ai"
source_file: "README.md"
branch: "main"
---
<h1 align="center">✨ skilless.ai</h1>

<p align="center">
  <strong>Empower Your Agent with Real Data</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.12+-green.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.12+"></a>
  <a href="https://github.com/brikerman/skilless.ai/stargazers"><img src="https://img.shields.io/github/stars/brikerman/skilless.ai?style=for-the-badge" alt="GitHub Stars"></a>
</p>

<p align="center">
  <a href="#quick-install">Quick Install</a> · <a href="README.zh.md">中文</a> · <a href="#four-core-tools">Core Tools</a> · <a href="#three-ai-skills">AI Skills</a> · <a href="https://skilless.ai">Website</a>
</p>

---

## Why Skilless?

Your AI is great at writing and thinking — but ask it to go look something up, and it hits a wall:

- 🔍 "Find recent reviews of this product" → **no good free search**, everything useful costs money
- 🌐 "Read what's on this webpage" → **returns raw HTML soup**, completely unreadable
- 📺 "What does this YouTube video cover?" → **can't extract subtitles**, too much manual work
- 📡 "Follow these news feeds and summarize updates" → **have to write the code yourself**

**Skilless turns this into one command:**

```bash
curl -LsSf https://skilless.ai/install | bash
```

Auto-detects your environment, creates an isolated virtual environment, installs all dependencies. Zero system pollution, no sudo required, uninstalls cleanly.

---

## What You Can Do After Installing

> 💡 **Recommended:** Use [OpenCode](https://opencode.ai) — open source, free, works great with Skilless out of the box. Also compatible with OpenClaw, Kilo Code, Cursor, and Claude Code.

Just tell your AI what you need — it reads the skill files and figures out the rest:

- "Find reviews of this product online" → searches the web
- "Read what's on this page and summarize it" → extracts clean content from any URL
- "What does this YouTube video talk about?" → pulls the transcript
- "What's new in this RSS feed?" → parses and summarizes the feed

**You don't need to remember any commands.** That's the point.

---

## Real-World Use Cases

### 📹 Video Download
- **YouTube** → Download videos for offline viewing, extract subtitles, or get transcripts
- **Bilibili** → Save Chinese videos locally, extract CC and danmaku
- **TikTok, Twitter/X, Twitch, Vimeo** → Download clips, VODs, and videos without watermarks
- **1700+ more sites** → Dailymotion, Rumble, Odysee, SoundCloud, Reddit video, and more

### 📝 Video Subtitles & Transcripts
- Extract auto-generated or manual subtitles from any video
- Organize fast-paced content into readable notes
- Translate video subtitles to your language
- Generate summaries from video transcripts

### 🎵 Media Processing
- Extract audio from video as MP3
- Compress large video files to save space
- Convert between formats (mkv→mp4, wav→mp3, etc.)

### 🔍 Web Search
- "Help me compare noise-canceling headphones under $300" → searches reviews across the web
- "What's the latest news on AI video generation?" → finds and summarizes recent articles
- "Research the best practices for RAG systems" → semantic search for technical content

### 🌐 Web Content
- "Read this article and summarize the key points" → extracts clean content
- "Extract the main points from this documentation" → parses technical docs
- "What does this page say about X?" → finds specific information

### 📊 Deep Research
- **Multi-source comparison** → "Compare the top 5 project management tools and recommend one for a small team"
- **Travel planning** → "Create a 7-day Tokyo guide with food and attraction recommendations"
- **Industry analysis** → "Research all video generation AI models and create a comprehensive report"
- **Fact-checked reports** → cross-validated information from multiple sources

### ✍️ Content Writing
- Draft professional emails on any topic
- Write articles backed by real research
- Create documentation with proper citations

---

**Real Example:** A user recently asked: *"Research all the video generation models on the market and create a comprehensive report."* Skilless automatically searched, read sources, cross-checked facts, and produced a structured multi-section report — all in one conversation.

---

## Three AI Skills

Skills are installed as `SKILL.md` files under `~/.agents/skills/`. Your Agent reads them automatically and knows when to use which capability:

| Skill | Purpose |
|-------|---------|
| **Brainstorming** | Turn vague ideas into actionable plans through dialogue — proposes 2-3 options with trade-offs |
| **Research** | Multi-source cross-validated deep research — transforms AI from text generator to active researcher |
| **Writing** | Produce articles, docs, and reports backed by real research data |

### Skill Ecosystem

The three skills work together as a connected system — each can invoke the others when needed:

```mermaid
graph LR
  B["🧠 Brainstorming"] -->|need data| R["🔍 Research"]
  B -->|document plan| W["✍️ Writing"]
  R -->|write report| W
  R -->|clarify scope| B
  W -->|gather data| R
  W -->|clarify brief| B
```

---

## Quick Install

**Mac / Linux**

```bash
curl -LsSf https://skilless.ai/install | bash
```

**Windows (PowerShell)**

```powershell
Invoke-RestMethod https://skilless.ai/install.ps1 | Invoke-Expression
```

<details>
<summary>What does this command actually install?</summary>

1. **Installs uv** — ultra-fast Python package manager, placed in `~/.local/bin`
2. **Network detection** — auto-detects your environment and switches to local mirrors (Tsinghua TUNA in China) if needed
3. **Isolated deployment** — creates a fully isolated virtual environment in `~/.agents/skills/skilless/` with all dependencies: `yt-dlp` `fastmcp` `jina reader` `feedparser`
4. **Exposes CLI** — generates the `skilless.ai` executable, ready to use immediately

*Zero system pollution · No sudo required · Easy to uninstall*
</details>

---

## Technology Stack

| Tool | Purpose |
|------|---------|
| [Jina Reader](https://github.com/jina-ai/reader) | Web page extraction |
| [Exa](https://exa.ai) | AI semantic search, free, no key needed |
| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Video & subtitle extraction, 1700+ sites |
| [feedparser](https://github.com/kurtmckee/feedparser) | RSS/Atom parsing |
| [uv](https://github.com/astral-sh/uv) | Ultra-fast Python package manager, isolated deployment |

---

## FAQ

<details>
<summary><strong>Do I need API keys?</strong></summary>

No. All tools use free tiers: Exa search is accessed for free via MCP, Jina Reader requires no key, yt-dlp runs entirely locally.
</details>

<details>
<summary><strong>Does this modify my system environment?</strong></summary>

No. Everything is installed in an isolated virtual environment under `~/.agents/skills/skilless/`. No sudo, no changes to global Python or Node.js.
</details>

<details>
<summary><strong>Which AI tools are supported?</strong></summary>

Any tool that reads SKILL.md files from `~/.agents/skills/` will work. We recommend **[OpenCode](https://opencode.ai)** — it's open source and free. Also works with OpenClaw, Kilo Code, Cursor, and Claude Code.
</details>

<details>
<summary><strong>How do I uninstall?</strong></summary>

```bash
rm -rf ~/.agents/skills/skilless
rm -rf ~/.agents/skills/skilless-*
```
</details>

---

## License

[MIT](https://github.com/BrikerMan/skilless.ai/tree/HEAD/LICENSE)
