opencode-skills

Automate OpenCode skill creation and governance with SKILL.md frontmatter conventions.

7|2|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/jal-co/jalco-opencode --skill opencode-skills-jal-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-skills
Source: https://github.com/jal-co/jalco-opencode/tree/main/opencode/.config/opencode/skills/opencode-skills
Command: npx skills add https://github.com/jal-co/jalco-opencode --skill opencode-skills-jal-co

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill defines a standard approach to creating and maintaining OpenCode skills using properly formatted SKILL.md frontmatter, enabling consistent naming, permissions, and reference organization across project and global scopes.

Core Features & Use Cases

  • Enforces SKILL.md frontmatter structure (name and description) and discourages drift from conventions.
  • Documents a predictable directory layout (.opencode/skill/<name>/ with optional scripts/, references/, assets/) to support skill discovery, loading, and governance.
  • Provides guidance for permission configuration and skill discovery to allow safe, modular agent capabilities.

Quick Start

Create a new skill named my-skill in .opencode/skill/my-skill with a valid SKILL.md.

Frequently Asked Questions about opencode-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an OpenCode skill with the correct folder structure?▼

OpenCode skills require a directory at .opencode/skill/<name>/ containing a SKILL.md file with valid frontmatter. The folder name must match the frontmatter name to ensure proper loading and agent discovery.

What frontmatter fields are required in a SKILL.md file?▼

SKILL.md frontmatter requires 'name' and 'description' fields. These mandatory fields enforce consistent naming and enable safe, modular agent capabilities across project and global scopes.

Can I use optional directories like scripts and references when building skills?▼

Yes, OpenCode skills support optional scripts/, references/, and assets/ directories within the skill folder. These components allow you to organize advanced resources for modular agent capabilities.

How does frontmatter validation prevent skill naming drift?▼

Frontmatter validation checks that the skill folder name matches the declared 'name' field. This discourages convention drift and maintains a predictable directory layout for skill discovery and governance.

Do I need permission templates to configure OpenCode skill discovery?▼

Permission templates are optional but recommended for configuring safe skill discovery. They provide guidance on managing modular agent capabilities by defining what permissions each skill requires.