Feedough Logo

How To Add Skills To OpenCode

By Aashish Pahwa

4 min read

[Reader Disclosure]Our content is reader-supported. This means we may earn a commission if you click on some of our links.

How to add skills to OpenCode comes down to one thing: folders. The docs show no install command. You add a folder with a SKILL.md file inside it, and OpenCode finds the skill on its own.

No skill to add yet? The AI Skill Generator writes one from your own examples, ready to unzip into .opencode/skills.

It also reads .claude and .agents folders, so skills you already have may just work as they are. The OpenCode skills documentation lists every folder it checks.

How To Add Skills To OpenCode

Adding a skill is folder work from start to finish. Here is the exact sequence, and none of it needs a command.

  1. Create the skill folder. For one project, make .opencode/skills/<name>/ inside that project. For every project on your machine, make ~/.config/opencode/skills/<name>/ instead.
  2. Add the file. Inside that folder, add a file called SKILL.md.
  3. Set the frontmatter. That is the settings block at the top of the file. In it, fill in name and description.

Both fields are required, so do not save the file with either one blank. The name has to run 1 to 64 characters. Use lowercase letters and numbers, with single hyphens between them. It also has to match the folder name exactly. So a folder called pdf-export needs name: pdf-export, not PDF_export.

The description is required as well. It runs 1 to 1024 characters, so you have room to say what the skill does in plain words.

Terminal commands creating an OpenCode skill in .opencode/skills
The OpenCode folder layout, created in a real terminal.

Where OpenCode Looks For Skills

Scope
Paths
Project
.opencode/skills//SKILL.md, .claude/skills//SKILL.md, .agents/skills//SKILL.md
Global
~/.config/opencode/skills//SKILL.md, ~/.claude/skills//SKILL.md, ~/.agents/skills//SKILL.md

Any of those six paths works. Pick the scope you want: project for one repo, global for every project on your machine.

For the project paths, OpenCode starts at your current folder and searches up to the git worktree. So the skill folder can sit at any level in between.

OpenCode debug output listing the summarize-changes skill
Check it worked: opencode debug skill lists the new skill.

How To Add Skills In OpenCode Desktop

OpenCode Desktop is OpenCode in an app window. OpenCode Desktop reads the same skill folders as the terminal version, so there is no separate install step. You can download OpenCode Desktop from the OpenCode download page.

  1. Add the skill folder to one of the folders listed above. Skills in ~/.claude/skills/ show up in OpenCode Desktop too.
  2. Open OpenCode Desktop and pick your project.
OpenCode Desktop home screen with a prompt box that says / for commands and @ for context
The OpenCode Desktop home screen. The prompt box hints at / for commands.
  1. Click the prompt box and type /. OpenCode Desktop lists commands and skills together.
OpenCode Desktop slash menu listing init, review and customize-opencode
The / menu in OpenCode Desktop. Skills sit in the same list as commands, so /customize-opencode here is a built-in skill.
  1. Keep typing the skill name to filter the list, then select the skill.
OpenCode Desktop prompt box with /which typed and the whichllm skill shown above it
Typing /which narrows the list to the whichllm skill, which sits in ~/.claude/skills/ on this PC.

How To Start A Skill

The docs show no user command. OpenCode’s agent loads a skill through its built-in skill tool. It picks the skill based on the description in the frontmatter. So write that line in a specific way, and name the tasks the skill is for.

You can control which skills load too. In opencode.json, use "permission": { "skill": { ... } }. Set allow, deny or ask per pattern.

If A Skill Does Not Show Up

A missing skill usually comes down to one of four small mistakes. Work through this list before you change anything else.

  • File name. It is SKILL.md inside the skill folder, not beside it.
  • Name field. The name matches the folder name exactly, and follows the rules above.
  • Description. The description is filled in, not left blank.
  • Permissions. opencode.json is not set to deny the skill.

Check A Skill Before You Add It

A skill can hold instructions and code. So treat adding one like installing software. Snyk’s scan of AI agent skills found 534 out of 3,984 skills with at least one critical issue, plus 76 confirmed malicious payloads.

Before you add anything, run three checks:

  • Who made it. Look for a name or a project you can trust.
  • What SKILL.md says. Read the whole file, not just the frontmatter.
  • What the scripts do. Open any script files and scan them first.

New to this? Read what an AI agent is, or our guide on how to build an AI agent.

Once you are happy, open OpenCode and add one small skill first.

Aashish Pahwa

Aashish Pahwa

A startup consultant, digital marketer, traveller, and philomath. Aashish has worked with over 20 startups and successfully helped them ideate, raise money, and succeed. When not working, he can be found hiking, camping, and stargazing.

Put this to work.

Free Feedough tools for the next step.

  1. AI Prompt GeneratorCreate powerful AI prompts instantly
  2. Free Image Prompt GeneratorGenerate creative image prompts
  3. Flux Prompt GeneratorCreate optimized Flux AI prompts
See all free tools