| name | minimal-skill |
| description | Demonstrates the absolute basics of an OpenCode skill |
Minimal Skill Example
What I Do
I demonstrate the simplest possible OpenCode skill structure to help you understand the fundamentals.
Key Concept
Skills are INSTRUCTIONS, not code. An OpenCode skill is a Markdown file with frontmatter that provides guidance to the AI assistant. The assistant reads the skill file and follows its instructions.
Structure
This skill contains only one file:
skills/minimal/
└── SKILL.md ← You are here!
That's it! No scripts, no configuration, no code. Just instructions in Markdown.
Frontmatter
Every OpenCode skill starts with YAML frontmatter:
---
name: skill-name
description: One-line description
---
This frontmatter tells OpenCode:
- name: The skill identifier (used in commands)
- description: Brief explanation of what the skill does
How to Use Me
Since this is just a demonstration skill, you can't really "use" me for anything practical. However, you can:
- Read this file to understand skill structure
- Copy the frontmatter as a template for new skills
- See the pattern - skills are instructions, not executable code
Example: Using the Bash Tool
When an OpenCode skill needs to execute commands, it uses the Bash tool. Here's a simple example:
echo "Hello from OpenCode skills!"
The AI assistant would execute this command and show you the output.
What This Demonstrates
- ✅ Basic frontmatter structure
- ✅ Skills as instructions (not code)
- ✅ Markdown-based documentation
- ✅ Simple pattern for quick POCs
- ✅ Instant understanding with minimal complexity
Next Steps
- Try the intermediate example to see helper script integration
- Try the advanced example to see full workflow orchestration
- Read the workflow patterns guide to understand sequential execution
Learning Objectives
After studying this minimal example, you should understand:
- What an OpenCode skill file looks like
- How frontmatter works
- That skills are instructions, not executable code
- The simplest possible skill structure
Difficulty: ⭐ (Absolute beginner)
Complexity: Minimal (1 file)
Learning Curve: Instant understanding
Use Case: Proof of concept, quick reference, educational demo
