Skill Creator Plus

Enhanced skill creator with templates, validation, publishing workflow, and quality gates.

Features

• Skill Templates: Ready-to-use templates for common skill types
• Validation Rules: Quality gates before publishing
• Publishing Workflow: ClawHub integration
• Best Practices: Proven patterns and anti-patterns
• Testing Framework: Validate skills before release

Quick Reference

Skill Anatomy

Directory Structure

skill-name/
├── SKILL.md (required)
├── scripts/ (optional)
│   └── helper.py
├── references/ (optional)
│   └── guide.md
└── assets/ (optional)
    └── template.txt

SKILL.md Structure

---
name: skill-name
description: "Clear description of what the skill does and when to use it."
metadata:
  author: your-name
  version: 1.0.0
  tags: tag1, tag2
  compatibility: opencode
  license: MIT
---

# Skill Name

## Overview
Brief overview of the skill.

## Features
- Feature 1
- Feature 2

## Usage
How to use the skill.

## Examples
Concrete examples.

Skill Templates

Knowledge Skill

---
name: knowledge-skill
description: "Domain knowledge for [topic]. Use when user asks about [specific topics]."
metadata:
  author: your-name
  version: 1.0.0
  tags: knowledge, domain
  compatibility: opencode
  license: MIT
---

# [Topic] Knowledge

## Overview
Brief overview of the domain.

## Key Concepts
- Concept 1: Definition
- Concept 2: Definition

## Common Patterns
1. Pattern 1: Description
2. Pattern 2: Description

## References
- [link1](url1)
- [link2](url2)

Workflow Skill

---
name: workflow-skill
description: "Automated workflow for [task]. Use when user wants to [action]."
metadata:
  author: your-name
  version: 1.0.0
  tags: workflow, automation
  compatibility: opencode
  license: MIT
---

# [Task] Workflow

## Overview
Brief overview of the workflow.

## Steps
1. Step 1: Description
2. Step 2: Description
3. Step 3: Description

## Commands

command1

command2

## Error Handling
- Error 1: Solution
- Error 2: Solution

Tool Integration Skill

---
name: tool-skill
description: "Integration with [tool/API]. Use when working with [tool]."
metadata:
  author: your-name
  version: 1.0.0
  tags: tool, integration
  compatibility: opencode
  license: MIT
---

# [Tool] Integration

## Overview
Brief overview of the tool.

## Setup
1. Install: `command`
2. Configure: `command`
3. Verify: `command`

## Usage

tool-command

## API Reference
- Method 1: Description
- Method 2: Description

## Examples

Example 1

command

Example 2

command

Validation Rules

Required Fields

• [ ] name: Skill name (lowercase, hyphens)
• [ ] description: Clear, comprehensive description

Description Quality

• [ ] What the skill does
• [ ] When to use it (triggers)
• [ ] Specific use cases
• [ ] No vague language

Structure Quality

• [ ] SKILL.md under 500 lines
• [ ] Progressive disclosure
• [ ] No extraneous files
• [ ] Clear organization

Content Quality

• [ ] Imperative/infinitive form
• [ ] Concise examples
• [ ] No duplication
• [ ] Actionable instructions

Publishing Workflow

1. Prepare

# Validate skill
clawhub validate skill-name

# Test locally
# Use skill in real scenarios

2. Publish

# Publish to ClawHub
clawhub publish skill-name --version "1.0.0"

# With options
clawhub publish skill-name \
  --name "Skill Display Name" \
  --slug "skill-slug" \
  --version "1.0.0" \
  --tags "tag1,tag2"

3. Verify

# Check publication
clawhub search skill-name

# Sync to local
clawhub sync

Quality Gates

Pre-Publish Checklist

• [ ] SKILL.md follows template
• [ ] Description is comprehensive
• [ ] No extraneous files
• [ ] Examples are clear
• [ ] Scripts are tested
• [ ] References are accurate
• [ ] License is specified

Post-Publish Verification

• [ ] Skill appears in ClawHub search
• [ ] Installation works
• [ ] Skill triggers correctly
• [ ] Instructions are clear
• [ ] Examples work

Common Patterns

Pattern 1: Progressive Disclosure

# Skill Name

## Quick Start
Basic usage example.

## Advanced Features
- Feature 1: See [FEATURE1.md](FEATURE1.md)
- Feature 2: See [FEATURE2.md](FEATURE2.md)

Pattern 2: Domain Organization

skill-name/
├── SKILL.md
└── references/
    ├── domain1.md
    ├── domain2.md
    └── domain3.md

Pattern 3: Conditional Loading

# Skill Name

## Basic Usage
Simple example.

## Advanced Usage
For complex scenarios, see [ADVANCED.md](ADVANCED.md).

Anti-Patterns

Testing Framework

Test Cases

1. Trigger Test: Does the skill activate correctly?
2. Instruction Test: Are instructions clear?
3. Example Test: Do examples work?
4. Error Test: Are errors handled?

Test Script

#!/bin/bash
# test-skill.sh

SKILL_NAME=$1

echo "Testing skill: $SKILL_NAME"

# Validate structure
clawhub validate $SKILL_NAME

# Test installation
clawhub install $SKILL_NAME

# Verify installation
ls -la ~/.openclaw/workspace/skills/$SKILL_NAME

echo "Test complete"

Best Practices

1. Start simple - Begin with basic skill, iterate
2. Be specific - Clear triggers and instructions
3. Add examples - Concrete use cases
4. Test thoroughly - Real-world testing
5. Document well - Clear SKILL.md
6. Publish regularly - Share improvements
7. Gather feedback - Iterate based on usage

ClawHub Integration

Search Skills

clawhub search "query"

Install Skills

clawhub install skill-name

Publish Skills

clawhub publish skill-name

Sync Skills

clawhub sync