OpenClaw Skill Template

A starter template for building custom OpenClaw skills in Python.

Overview

This template provides the minimal structure required for an OpenClaw skill:

your-skill/
├── SKILL.md       # Skill definition (required by OpenClaw)
└── main.py        # Skill logic (Python)

Getting Started

1. Clone this template

git clone https://github.com/your-username/your-skill.git
cd your-skill

2. Configure SKILL.md

Update the frontmatter and instructions in SKILL.md:

---
name: your_skill_name
description: What your skill does.
---

3. Implement your logic

Edit main.py and fill in the run() function with your skill's logic.

4. Install the skill

Copy the directory into your OpenClaw workspace:

cp -r . ~/.openclaw/workspace/skills/your-skill-name

Then ask your agent to "refresh skills" or restart the gateway.

5. Test it

python main.py

Or via the OpenClaw CLI:

openclaw agent --message "use my new skill"

Output Format

All skills built from this template return a standard JSON response:

{
  "status": "success",
  "data": {}
}

Field	Type	Description
status	string	"success" or "error"
data	object	The result payload

Resources

• OpenClaw Docs — Creating Skills
• ClawHub — Browse & share skills