Submit a Skill

Create a directory for your skill with a SKILL.md file. This is the core of every TrustedSkills skill — readable by OpenClaw, and exportable to MCP, Claude, and OpenAI formats.

---
name: my-skill-name
description: "One-line description of what your skill does (10-500 chars)"
version: 1.0.0
metadata: {"openclaw":{"emoji":"🔧"},"platforms":["openclaw","mcp"]}
---

## Instructions

Describe how the agent should use this skill. This text is injected
into the system prompt when the skill is active.

## Tools

### `my_tool_name`

What this tool does.

**Parameters:**
- `param1` (string, required): Description of the parameter

**Returns:** What the tool returns

Set the platforms field to list which AI platforms your skill supports. Skills that support multiple platforms get wider exposure.

Supported values: openclaw mcp claude openai cursor huggingface

If your skill uses custom tools, add handler files in a tools/ directory.

Push your skill to a public GitHub repository and add the openclaw-skill topic tag so it's auto-discoverable.

git init my-skill && cd my-skill
git add .
git commit -m "Initial skill"
gh repo create my-skill --public --push
gh repo edit --add-topic openclaw-skill

Create a tagged release with your skill as a zip artifact. The scraper uses release metadata for versioning.

git tag v1.0.0
git push origin v1.0.0
gh release create v1.0.0 \
  --title "v1.0.0" \
  --notes "Initial release" \
  my-skill.zip

Open a pull request to add your skill to the sources.json file in the TrustedSkills registry repository.

{
  "type": "github_repo",
  "repo": "yourusername/my-skill",
  "skills_path": ".",
  "official": false
}

Or wait up to 6 hours — if your repo has the openclaw-skill topic, it will be auto-discovered by the scraper.