Skill Creator

Create, edit, improve, or audit AgentSkills. Guidance for authoring SKILL.md files and structuring skill directories.

The Skill Creator is OpenClaw's meta-skill — a skill for creating, editing, improving, and auditing other skills. It contains the complete AgentSkills specification, best practices for SKILL.md authoring, and guidelines for structuring skill directories. When you ask OpenClaw to 'create a skill for X' or 'improve this skill,' this is the skill that guides the process. The AgentSkills format is OpenClaw's approach to extending AI agent capabilities. Unlike MCP servers (which expose tools via JSON-RPC), skills are Markdown-based instruction files (SKILL.md) that teach the agent how to use CLI tools, APIs, or workflows. The Skill Creator knows the full specification: required sections (description, requirements, usage), optional sections (examples, gotchas, references), directory structure conventions (scripts/, references/, templates/), and quality standards. The skill walks the agent through a structured creation process: understand the tool or API, identify its core commands and patterns, write clear usage instructions with examples, document requirements (binaries, env vars, API keys), add gotchas and tips, and organize supporting files. The result is a well-structured skill directory that any OpenClaw instance can install and use. For improving existing skills, the Skill Creator provides an audit checklist: Are the examples correct? Are requirements complete? Are gotchas documented? Is the description clear? It can restructure messy skill directories — moving scripts to scripts/, reference docs to references/, and ensuring SKILL.md follows the spec. The OpenClaw skills ecosystem has grown rapidly — ClawHub hosts over 13,000 community-built skills as of early 2026, though quality varies widely. The Skill Creator helps raise the bar by enforcing consistent standards and comprehensive documentation. Best suited for: developers creating new skills for OpenClaw, maintaining and improving existing skills, anyone wanting to contribute to the OpenClaw skills ecosystem, teams standardizing their custom skill libraries.

Tags: skills, authoring, developer-tools, meta

Category: Developer Tools

Use Cases

  • Create a new skill for a CLI tool you use daily
  • Wrap an API (Notion, Linear, Stripe) as an OpenClaw skill
  • Audit and improve community skills before installing them
  • Standardize internal skills across a team's OpenClaw instances
  • Restructure messy skill directories to follow the spec
  • Generate comprehensive SKILL.md from tool documentation

Tips

  • Start with the README or docs of the tool you're wrapping — feed them to the agent alongside this skill
  • Use 'audit' mode to review existing skills before editing — it catches missing sections systematically
  • Include real, tested examples in SKILL.md — the agent will use them as templates for its own commands
  • Add gotchas proactively — they save future users hours of debugging
  • Keep SKILL.md focused — reference docs go in references/, complex scripts go in scripts/
  • Test the skill in a fresh OpenClaw session to verify it works without prior context
  • Publish to ClawHub to share with the community: the review process catches quality issues

Known Issues & Gotchas

  • This skill teaches the agent HOW to create skills — it doesn't auto-generate them from nothing
  • The AgentSkills spec may evolve — check the latest version in the OpenClaw repo
  • Quality of generated skills depends on how well the agent understands the target tool/API
  • Skills created locally need to be published to ClawHub for community distribution
  • The skill assumes familiarity with the target tool — garbage in, garbage out
  • Supporting files (scripts, references) should be in the skill directory, not referenced externally
  • Skill directories have a naming convention — lowercase, hyphenated, matching the tool name

Alternatives

  • Manual SKILL.md authoring
  • MCP Server creation
  • ClawHub templates
  • Copying existing skills

Community Feedback

The skill-creator skill provides guidance for authoring SKILL.md files following the AgentSkills specification. It covers directory structure, required sections, and quality standards.

— GitHub (OpenClaw)

agent-skill-creator: A meta-skill for creating and auditing AgentSkills. Generates well-structured SKILL.md files with proper requirements, examples, and gotchas.

— Smithery

Skill Creator: Create, edit, improve, or audit AgentSkills. Guidance for authoring SKILL.md files and structuring skill directories. Essential meta-skill for the ecosystem.

— awesome-openclaw-skills

Configuration Examples

Create a new skill

# Ask your OpenClaw agent:
"Create a skill for the 'httpie' CLI tool. It should cover GET/POST requests, 
authentication, JSON output, and file downloads."

# The agent reads skill-creator's SKILL.md, then generates:
# skills/httpie/
#   SKILL.md
#   references/
#   scripts/

Audit an existing skill

# Ask your OpenClaw agent:
"Audit the weather skill and suggest improvements."

# The agent checks for:
# - Missing sections (requirements, examples, gotchas)
# - Outdated information
# - Incomplete configuration examples
# - Missing error handling guidance

Skill directory structure

my-skill/
├── SKILL.md           # Main instruction file (required)
├── scripts/           # Helper scripts
│   └── setup.sh
├── references/        # API docs, spec files
│   └── api-spec.md
└── templates/         # Template files
    └── config.json

Installation

# Built-in (bundled with OpenClaw)

Source: bundled