# Minimal Skill

> Demonstrates the absolute basics of an OpenCode skill

- Skill: `digi4care/minimal-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add digi4care/minimal-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/digi4care/minimal-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: digi4care (https://skillmd.com/u/digi4care)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/digi4care/minimal-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:

```yaml
---
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:

1. **Read this file** to understand skill structure
2. **Copy the frontmatter** as a template for new skills
3. **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:

```bash
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:

1. What an OpenCode skill file looks like
2. How frontmatter works
3. That skills are instructions, not executable code
4. 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