Awesome OpenCode Skills

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

Contents

• What Are OpenCode Skills?
• Skills
  • Document Processing
  • Development & Code Tools
  • Data & Analysis
  • Business & Marketing
  • Communication & Writing
  • Creative & Media
  • Productivity & Organization
  • Collaboration & Project Management
  • Security & Systems
• Getting Started
• Creating Skills
• Contributing
• Resources
• 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 - Create, edit, analyze Word docs with tracked changes, comments, formatting. 📖 Comprehensive
• pdf - Extract text, tables, metadata, merge & annotate PDFs. 📖 Comprehensive
• pptx - Read, generate, and adjust slides, layouts, templates. 📄 Standard
• xlsx - Spreadsheet manipulation: formulas, charts, data transformations. 📄 Standard
• More skills coming soon!

Development & Code Tools

• 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 - Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes. 📄 Standard
• 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 - Provides guidance for creating effective OpenCode Skills that extend capabilities with specialized knowledge, workflows, and tool integrations. 📖 Comprehensive
• Staff Engineer Review - Performs deep code review of pull requests as a Staff+ engineer, evaluating alignment, architecture, code quality, correctness, performance, and test coverage. 📄 Standard
• 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 - Applies OpenCode's official brand colors and typography to artifacts for consistent visual identity and professional design standards. 📄 Standard
• Competitive Ads Extractor - Extracts and analyzes competitors' ads from ad libraries to understand messaging and creative approaches that resonate. 📖 Comprehensive
• Domain Name Brainstormer - Generates creative domain name ideas and checks availability across multiple TLDs including .com, .io, .dev, and .ai extensions. 📖 Comprehensive
• 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 - 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 - Assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback. 📖 Comprehensive
• 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 - Creates beautiful visual art in PNG and PDF documents using design philosophy and aesthetic principles for posters, designs, and static pieces. 📖 Comprehensive
• Image Enhancer - Improves image and screenshot quality by enhancing resolution, sharpness, and clarity for professional presentations and documentation. 📄 Standard
• Slack GIF Creator - Creates animated GIFs optimized for Slack with validators for size constraints and composable animation primitives. 📖 Comprehensive
• 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 - 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 - Intelligently organizes files and folders by understanding context, finding duplicates, suggesting better organizational structures, and automating cleanup tasks. 📖 Comprehensive
• Invoice Organizer - Automatically organizes invoices and receipts for tax preparation by reading files, extracting information, and renaming consistently. 📖 Comprehensive
• 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

• Code Security Auditor - Performs pre-execution security audits of untrusted codebases through static analysis to identify supply chain risks and security vulnerabilities. 📖 Comprehensive

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:

   mkdir -p ~/.config/opencode/skill/
   cp -r skill-name ~/.config/opencode/skill/

   Or use the helper script:

   ./scripts/install_opencode_skills.sh --global

2. Start OpenCode:

   opencode

3. The skill loads automatically and activates when relevant.

Project-Local Installation

1. Install skills to your project directory:

   mkdir -p .opencode/skill/
   cp -r skill-name .opencode/skill/

   Or use the helper script:

   ./scripts/install_opencode_skills.sh --project

2. Start OpenCode in your project:

   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:

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:

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)

{
  "$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)

{
  "$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)

{
  "$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:

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

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

{
  "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:

{
  "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:

{
  "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):

{
  "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):

{
  "$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
• Python: 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

---
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 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 - Official skills guide
• OpenCode Config Documentation - Configuration reference
• OpenCode GitHub Repository - Source code and issues

Community Resources

• OpenCode Discord - Discuss OpenCode with other users
• OpenCode Documentation - Comprehensive documentation

Inspiration & Use Cases

• Lenny's Newsletter - 50 ways people use AI coding agents
• Notion Skills - 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.

---

☕ Support This Project

Help keep this project going — use a referral link below and both of us get credits!

Service	Your Bonus	Details	Referral Code
Neuralwatt	$10 in credits	Spend $10+ → you get $10, we get $20	NW-ROGER-ET3Y
Synthetic	$10 in credits	Subscribe → both get $10 credit	UAWqkKQQLFkzMkY