Create Skill
A callable skill factory designed for programmatic invocation by other skills.
Usage
This skill is typically called by other skills with structured parameters. Call it when you need to generate a new skill programmatically.
Parameters
When calling this skill, provide the following parameters:
| Parameter | Required | Description |
|---|---|---|
name |
Yes | Skill name (lowercase, hyphens only, <64 chars) |
description |
Yes | Skill description for frontmatter (include what it does + when to use) |
instructions |
Yes | Markdown body content for SKILL.md |
scripts |
No | List of script files to create: [{name, content, language}] |
references |
No | List of reference docs: [{name, content}] |
assets |
No | List of asset files: [{name, content}] |
output_dir |
No | Output directory (default: ~/.openclaw/workspace/skills) |
validate |
No | Run validation after creation (default: true) |
package |
No | Generate .skill file after creation (default: true) |
Calling Convention
Call this skill with a structured request:
{
"name": "my-skill",
"description": "Brief description of what this skill does and when to use it.",
"instructions": "## Overview\n\nDetailed instructions in markdown...",
"scripts": [
{"name": "main.py", "content": "#!/usr/bin/env python3\n...", "language": "python"}
],
"references": [
{"name": "api-docs.md", "content": "# API Reference\n..."}
]
}
Workflow
- Validate parameters - Check skill_name format, required fields
- Create directory structure -
skill_name/with appropriate subdirectories - Generate SKILL.md - Write frontmatter + instructions
- Create resources - Write scripts, references, assets if provided
- Validate - Run skill validation (optional, default: on)
- Package - Generate .skill file (optional, default: on)
- Return result - Report created files and location
Output
Returns a result object:
{
"success": true,
"skill_path": "~/.openclaw/workspace/skills/my-skill",
"skill_file": "~/.openclaw/workspace/skills/my-skill.skill",
"files_created": ["SKILL.md", "scripts/main.py"]
}
Quick Example
A calling skill might invoke this with:
Create a skill named "pdf-watermarker" that:
- Description: "Add watermarks to PDF files. Use when processing PDFs for branding or security."
- Instructions: Basic watermarking workflow with pdfplumber
- Scripts: A watermark.py script using PyPDF2
The skill factory handles all file creation, validation, and packaging.
Resources
scripts/
create_skill.py- Main skill creation scriptvalidate_skill.py- Validation utilities (wraps skill-creator's package_skill.py)
references/
skill-spec.md- AgentSkills specification reference