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.