Skills Skill Md Template

SKILL.md Template Reference

The SKILL.md file is the core of every OpenClaw skill. It tells the agent what the skill does, when to use it, and how to execute it. This reference provides the recommended template and explains each section.

Complete Template

---
name: your-skill-name
description: A concise one-line description of what this skill does
version: 1.0.0
author: your-name
tags: [category1, category2, category3]
permissions:
  fileAccess: [./output]
  commands: [node, npm]
  network: [api.example.com]
---

# Skill Name

## Purpose
Explain what this skill accomplishes and when it should be used.

## Usage
Describe how to invoke this skill. Include example prompts:
- "Run the standup report for today"
- "Generate a weekly summary"

## Steps
1. Step one with specific instructions
2. Step two with code blocks if needed
3. Step three with expected output

## Output Format
Describe the expected output format.

## Error Handling
Describe what to do if common errors occur.

Frontmatter Fields

• name: Unique identifier, lowercase with hyphens. Must match the folder name.
• description: One sentence. Shown in skill search results and ClawHub listings.
• version: Semantic versioning (major.minor.patch)
• permissions: Explicitly declare what access the skill needs. Agents enforce these boundaries at runtime.