# awesome-opencode-skills

**Repository Path**: null_251_0492/awesome-opencode-skills

## Basic Information

- **Project Name**: awesome-opencode-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">Awesome OpenCode Skills</h1>

<p align="center">
  <a href="https://awesome.re">
    <img src="https://awesome.re/badge.svg" alt="Awesome" />
  </a>
  <a href="https://makeapullrequest.com">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" />
  </a>
  <a href="https://www.apache.org/licenses/LICENSE-2.0">
    <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square" alt="License: Apache-2.0" />
  </a>
</p>

A curated list of practical OpenCode Skills for enhancing productivity across the OpenCode ecosystem.

## Contents

- [What Are OpenCode Skills?](#what-are-opencode-skills)
- [Skills](#skills)
  - [Document Processing](#document-processing)
  - [Development & Code Tools](#development--code-tools)
  - [Data & Analysis](#data--analysis)
  - [Business & Marketing](#business--marketing)
  - [Communication & Writing](#communication--writing)
  - [Creative & Media](#creative--media)
  - [Productivity & Organization](#productivity--organization)
  - [Collaboration & Project Management](#collaboration--project-management)
  - [Security & Systems](#security--systems)
- [Getting Started](#getting-started)
- [Creating Skills](#creating-skills)
- [Contributing](#contributing)
- [Resources](#resources)
- [License](#license)

## What Are OpenCode Skills?

OpenCode Skills are customizable workflows that teach OpenCode how to perform specific tasks according to your unique requirements. Skills enable OpenCode to execute tasks in a repeatable, standardized manner across all OpenCode interfaces.

## Skills

### Document Processing

- [docx](./document-skills/docx/) - Create, edit, analyze Word docs with tracked changes, comments, formatting. 📖 **Comprehensive**
- [pdf](./document-skills/pdf/) - Extract text, tables, metadata, merge & annotate PDFs. 📖 **Comprehensive**
- [pptx](./document-skills/pptx/) - Read, generate, and adjust slides, layouts, templates. 📄 **Standard**
- [xlsx](./document-skills/xlsx/) - Spreadsheet manipulation: formulas, charts, data transformations. 📄 **Standard**
- More skills coming soon!

### Development & Code Tools

- [artifacts-builder](./artifacts-builder/) - Suite of tools for creating elaborate, multi-component HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). 📄 **Standard**
- [Changelog Generator](./changelog-generator/) - Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes. 📄 **Standard**
- [MCP Builder](./mcp-builder/) - Guides creation of high-quality MCP (Model Context Protocol) servers for integrating external APIs and services with LLMs using Python or TypeScript. 📖 **Comprehensive**
- [Skill Creator](./skill-creator/) - Provides guidance for creating effective OpenCode Skills that extend capabilities with specialized knowledge, workflows, and tool integrations. 📖 **Comprehensive**
- More skills coming soon!
- [Webapp Testing](./webapp-testing/) - Tests local web applications using Playwright for verifying frontend functionality, debugging UI behavior, and capturing screenshots. 📄 **Standard**

### Data & Analysis

- More skills coming soon!

### Business & Marketing

- [Brand Guidelines](./brand-guidelines/) - Applies OpenCode's official brand colors and typography to artifacts for consistent visual identity and professional design standards. 📄 **Standard**
- [Competitive Ads Extractor](./competitive-ads-extractor/) - Extracts and analyzes competitors' ads from ad libraries to understand messaging and creative approaches that resonate. 📖 **Comprehensive**
- [Domain Name Brainstormer](./domain-name-brainstormer/) - Generates creative domain name ideas and checks availability across multiple TLDs including .com, .io, .dev, and .ai extensions. 📖 **Comprehensive**
- [Internal Comms](./internal-comms/) - Helps write internal communications including 3P updates, company newsletters, FAQs, status reports, and project updates using company-specific formats. 📄 **Standard**
- [Lead Research Assistant](./lead-research-assistant/) - Identifies and qualifies high-quality leads by analyzing your product, searching for target companies, and providing actionable outreach strategies. 📖 **Comprehensive**

### Communication & Writing

- [Content Research Writer](./content-research-writer/) - Assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback. 📖 **Comprehensive**
- [Meeting Insights Analyzer](./meeting-insights-analyzer/) - Analyzes meeting transcripts to uncover behavioral patterns including conflict avoidance, speaking ratios, filler words, and leadership style. 📖 **Comprehensive**
- More skills coming soon!

### Creative & Media

- [Canvas Design](./canvas-design/) - Creates beautiful visual art in PNG and PDF documents using design philosophy and aesthetic principles for posters, designs, and static pieces. 📖 **Comprehensive**
- [Image Enhancer](./image-enhancer/) - Improves image and screenshot quality by enhancing resolution, sharpness, and clarity for professional presentations and documentation. 📄 **Standard**
- [Slack GIF Creator](./slack-gif-creator/) - Creates animated GIFs optimized for Slack with validators for size constraints and composable animation primitives. 📖 **Comprehensive**
- [Theme Factory](./theme-factory/) - Applies professional font and color themes to artifacts including slides, docs, reports, and HTML landing pages with 10 pre-set themes. 📄 **Standard**
- [Video Downloader](./video-downloader/) - Downloads videos from YouTube and other platforms for offline viewing, editing, or archival with support for various formats and quality options. 📄 **Standard**
- More skills coming soon!

### Productivity & Organization

- [File Organizer](./file-organizer/) - Intelligently organizes files and folders by understanding context, finding duplicates, suggesting better organizational structures, and automating cleanup tasks. 📖 **Comprehensive**
- [Invoice Organizer](./invoice-organizer/) - Automatically organizes invoices and receipts for tax preparation by reading files, extracting information, and renaming consistently. 📖 **Comprehensive**
- [Raffle Winner Picker](./raffle-winner-picker/) - Randomly selects winners from lists, spreadsheets, or Google Sheets for giveaways and contests with cryptographically secure randomness. 📄 **Standard**
- More skills coming soon!

### Collaboration & Project Management

- More skills coming soon!

### Security & Systems

- More skills coming soon!

## Skill Depth Legend

Skills are categorized by documentation depth:

- 📖 **Comprehensive** (250+ lines): Detailed guides with extensive examples, workflows, and best practices. Ideal for learning a skill in depth.
- 📄 **Standard** (50-250 lines): Well-documented skills with clear instructions and examples. Ready to use quickly with sufficient guidance.
- 📄 **Quick Reference** (<50 lines): Concise reference guides for simple tasks or frequently used commands.

## Getting Started

### Using Skills in OpenCode

#### Global Installation

1. Install skills to your global OpenCode directory:
   ```bash
   mkdir -p ~/.config/opencode/skill/
   cp -r skill-name ~/.config/opencode/skill/
   ```

   Or use the helper script:
   ```bash
   ./scripts/install_opencode_skills.sh --global
   ```

2. Start OpenCode:
   ```bash
   opencode
   ```

3. The skill loads automatically and activates when relevant.

#### Project-Local Installation

1. Install skills to your project directory:
   ```bash
   mkdir -p .opencode/skill/
   cp -r skill-name .opencode/skill/
   ```

   Or use the helper script:
   ```bash
   ./scripts/install_opencode_skills.sh --project
   ```

2. Start OpenCode in your project:
   ```bash
   cd /path/to/project
   opencode
   ```

 3. Skills are discovered from `.opencode/skill/` directories.

### MCP Server for Skill Management 🚀

**NEW:** Manage OpenCode skills easier with our MCP server! The server provides 8 tools to browse, install, search, and manage OpenCode skills from within OpenCode.

---

## Getting Started with the MCP Server

### Step 1: Choose Your Runtime

#### TypeScript/Node.js (Recommended)
- Faster startup (~20ms with bun, ~50ms with node)
- Smaller memory footprint (~35MB)
- Modern npm/bun ecosystem
- Type-safe with Zod schemas

**Build the server:**

```bash
cd opencode-skills-mcp-server-ts

# Using npm
npm install && npm run build

# Using bun
bun install && bun run build
```

#### Python
- Mature PyPI ecosystem
- Familiar Python patterns
- Comprehensive logging to file + console
- Runtime type checking with Pydantic

**Build the server:**

```bash
cd opencode-skills-mcp-server

# Using the setup script (recommended)
./setup.sh

# Or manually
pip install -e .
```

---

### Step 2: Configure OpenCode

Add the MCP server to your OpenCode config file. The config location depends on your OS:

**Linux/macOS:** `~/.config/opencode/config.json`  
**Windows:** `%APPDATA%\opencode\config.json`

**Option A: Using node (TypeScript compiled)**

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["node"],
      "args": ["/absolute/path/to/opencode-skills-mcp-server-ts/dist/index.js"],
      "enabled": true
    }
  }
}
```

**Option B: Using bun (TypeScript with bun)**

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["bun"],
      "args": ["run", "/absolute/path/to/opencode-skills-mcp-server-ts/src/index.ts"],
      "enabled": true
    }
  }
}
```

**Option C: Using python (Python runtime)**

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["python3"],
      "args": ["-m", "opencode_skills_mcp"],
      "enabled": true
    }
  }
}
```

**Tips for paths:**
- Use absolute paths (e.g., `/home/user/...` or `C:\Users\...`)
- Or use home expansion with `{env:HOME}` on Linux/macOS
- Make sure the path matches your chosen runtime (TypeScript needs `dist/index.js`, Python can use module import)

---

### Step 3: Restart OpenCode

Restart OpenCode to load the MCP server:

```bash
# Stop OpenCode (Ctrl+C)
opencode
```

The MCP server will start automatically when OpenCode launches, and the 8 skill management tools will be available.

---

### Step 4: Use the MCP Tools

Once configured, you can use the MCP tools directly in OpenCode:

```bash
# List all available skills
/list_skills

# List skills filtered by category
/list_skills with category "Development"

# Get detailed information about a skill
/get_skill_info for skill "content-research-writer"

# Install a skill globally
/install_skill with skill_name "file-organizer" and scope "global"

# Search for skills
/search_skills with query "document processing"

# Get recommended skill combinations
/get_combinations with category "Writing"

# Install an entire workflow
/install_workflow with workflow_name "content-pipeline" and scope "global"

# Validate a skill structure
/validate_skill with skill_path "/path/to/skill/directory"
```

---

## MCP Server Options

Your config supports additional options for customization:

```json
{
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["node"],
      "args": ["/path/to/opencode-skills-mcp-server-ts/dist/index.js"],
      "enabled": true,
      "timeout": 5000,
      "environment": {
        "SKILLS_DIR": "/custom/path/to/skills"
      }
    }
  }
}
```

**Available options:**
- `enabled` - Enable or disable the server (default: `true`)
- `timeout` - Timeout in ms for loading tools (default: `5000`)
- `environment` - Environment variables for the server (e.g., custom skills path)

---

## Disabling the MCP Server

To temporarily disable the MCP server without removing it from your config:

```json
{
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["node"],
      "args": ["/path/to/opencode-skills-mcp-server-ts/dist/index.js"],
      "enabled": false
    }
  }
}
```

Or disable all tools from the server globally:

```json
{
  "mcp": {
    "opencode-skills": { /* ... */ }
  },
  "tools": {
    "opencode-skills*": false
  }
}
```

---

## Per-Agent Configuration

If you use multiple agents, you can enable the MCP server per-agent instead of globally:

**OpenCode Config (disable globally):**

```json
{
  "mcp": {
    "opencode-skills": {
      "type": "local",
      "command": ["node"],
      "args": ["/path/to/opencode-skills-mcp-server-ts/dist/index.js"],
      "enabled": true
    }
  },
  "tools": {
    "opencode-skills*": false
  }
}
```

**Agent Config (enable for specific agent):**

```json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "developer-assistant": {
      "tools": {
        "opencode-skills*": true
      }
    }
  }
}
```

---

## Available MCP Tools

| Tool | Description | Example |
|------|-------------|---------|
| `list_skills` | Browse all skills with filters | `list_skills with category "Development"` |
| `get_skill_info` | View detailed skill information | `get_skill_info for skill "content-research-writer"` |
| `install_skill` | Install skills globally/locally | `install_skill with skill_name "file-organizer"` |
| `uninstall_skill` | Remove installed skills | `uninstall_skill with skill_name "old-skill"` |
| `search_skills` | Find skills by keywords | `search_skills with query "document"` |
| `validate_skill` | Check SKILL.md structure | `validate_skill with skill_path "/path/to/skill"` |
| `get_combinations` | Get workflow combinations | `get_combinations with category "Writing"` |
| `install_workflow` | Install entire workflow | `install_workflow with workflow_name "content-pipeline"` |

---

## Troubleshooting

### MCP server doesn't start

1. **Check path is absolute:** Use full paths, not relative paths
2. **Verify dependencies are installed:** Run `npm install` or `pip install -e .`
3. **Check file permissions:** Ensure the entry point file is executable
4. **Review logs:** Check `logs/opencode_skills_mcp.log` (Python version)

### Tools not appearing

1. **Restart OpenCode** after adding config
2. **Check `enabled: true`** is set in your config
3. **Verify syntax:** Ensure JSON is valid (no syntax errors)
4. **Check timeout:** Increase `timeout` if tools take time to load (default: 5000ms)

### Skills not found

1. **Ensure skills_metadata.json exists** in the MCP server directory
2. **Check SKILLS_DIR environment** if you customized the path
3. **Verify skill directory** exists in your awesome-opencode-skills repository

**MCP Tools Available:**
- `list_skills` - Browse all skills with filters
- `get_skill_info` - View detailed skill information
- `install_skill` - Install skills globally/locally
- `uninstall_skill` - Remove skills
- `search_skills` - Find skills by keywords
- `validate_skill` - Check SKILL.md structure
- `get_combinations` - Get recommended workflow combinations
- `install_workflow` - One-command workflow installation

**See full documentation:**
- TypeScript: [opencode-skills-mcp-server-ts/README.md](./opencode-skills-mcp-server-ts/README.md)
- Python: [opencode-skills-mcp-server/README.md](./opencode-skills-mcp-server/README.md)

## Creating Skills

### Skill Structure

Each skill is a folder containing a `SKILL.md` file with YAML frontmatter:

```
skill-name/
├── SKILL.md          # Required: Skill instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files
```

### Basic Skill Template

```markdown
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---

# My Skill Name

Detailed description of the skill's purpose and capabilities.

## When to Use This Skill

- Use case 1
- Use case 2
- Use case 3

## Instructions

[Detailed instructions for OpenCode on how to execute this skill]

## Examples

[Real-world examples showing the skill in action]
```

### Skill Best Practices

- Focus on specific, repeatable tasks
- Include clear examples and edge cases
- Write instructions for OpenCode, not end users
- Test with OpenCode
- Document prerequisites and dependencies
- Include error handling guidance

## Contributing

We welcome contributions! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on:

- How to submit new skills
- Skill quality standards
- Pull request process
- Code of conduct

### Quick Contribution Steps

1. Ensure your skill is based on a real use case
2. Check for duplicates in existing skills
3. Follow the skill structure template
4. Test your skill with OpenCode
5. Submit a pull request with clear documentation

## Resources

### Official Documentation

- [OpenCode Skills Documentation](https://opencode.ai/docs/skills/) - Official skills guide
- [OpenCode Config Documentation](https://opencode.ai/docs/config/) - Configuration reference
- [OpenCode GitHub Repository](https://github.com/sst/opencode) - Source code and issues

### Community Resources

- [OpenCode Discord](https://opencode.ai/discord) - Discuss OpenCode with other users
- [OpenCode Documentation](https://opencode.ai/docs) - Comprehensive documentation

### Inspiration & Use Cases

- [Lenny's Newsletter](https://www.lennysnewsletter.com/p/everyone-should-be-using-claude-code) - 50 ways people use AI coding agents
- [Notion Skills](https://www.notion.so/notiondevs/Notion-Skills-for-Claude-28da4445d27180c7af1df7d8615723d0) - Notion integration skills

## License

This repository is licensed under the Apache License 2.0.

Individual skills may have different licenses - please check each skill's folder for specific licensing information.

---

**Note**: OpenCode Skills are compatible with OpenCode's skill system. Skills are automatically discovered from `~/.config/opencode/skill/`, `.opencode/skill/`, and `.claude/skills/` directories, ensuring seamless integration.