skill-dev-guide（技能开发指南）

Skill Development Guide / Skill 开发指南

A comprehensive guide to creating Skills for ClawHub and OpenClaw.

一份完整的 Skill 开发教程，适用于 ClawHub 和 OpenClaw 平台。

Quick Start / 快速开始

A Skill is a reusable prompt template that extends AI capabilities. Every Skill needs a SKILL.md file.

Skill 是一个可复用的提示词模板，用于扩展 AI 能力。每个 Skill 都需要一个 SKILL.md 文件。

Minimal Structure / 最小结构

# My Skill Name

Short description of what this skill does.

---

instructions: |
  You are a helpful assistant that...

  ## Your Task
  1. Step one
  2. Step two

Core Concepts / 核心概念

1. Instructions Block / 指令块

The instructions field defines AI behavior:

instructions: |
  You are an expert at [task].

  ## Guidelines
  - Be concise
  - Focus on accuracy

Tips / 提示:

• Use clear, specific language / 使用清晰具体的语言
• Break complex tasks into steps / 将复杂任务分解为步骤
• Avoid ambiguous instructions / 避免模糊的指令

2. Scripts (Optional) / 脚本（可选）

Add automation with bash scripts:

scripts:
  - name: validate
    description: Validate input data
    command: ./scripts/validate.sh

Security Rules / 安全规则:

• Never use set -a (exports all variables) / 禁止使用 set -a
• Avoid hardcoded secrets / 避免硬编码密钥
• Use explicit variable exports / 使用显式变量导出

3. Allowed Commands / 允许的命令

Declare which commands your skill needs:

allowed_commands:
  - curl
  - jq
  - node

Best Practices / 最佳实践

Passing Security Scan / 通过安全扫描

Writing Good Instructions / 写好指令

1. Be Specific / 具体明确

- Bad: "Help with code" - Good: "Review Python code for security vulnerabilities"

1. Provide Context / 提供上下文

- Include relevant background information - Define technical terms if needed

1. Set Boundaries / 设定边界

- Specify what the skill should NOT do - Define output format expectations

Examples / 示例

Basic Example / 基础示例

See examples/minimal.md for a starter template.

With Scripts / 带脚本示例

See examples/with-script.md for automation patterns.

Real-World Reference / 实际项目参考

For a complete MCP + Skill implementation example, check out:

• data-verify-mcp - A data validation tool with full documentation

Common Mistakes / 常见错误

FAQ / 常见问题

Q: How do I test my skill locally?

A: Use the ClawHub CLI or import directly in OpenClaw.

Q: Can I use external APIs?

A: Yes, but document them clearly in your skill description.

Q: Where can I get help?

A: Open an issue for discussion and questions:

• https://github.com/CCCpan/data-verify-mcp/issues

Resources / 资源

• SKILL.md Template - Ready-to-use template
• ClawHub Documentation
• OpenClaw Guide

Author / 作者

Created by @CCCpan

Found this helpful? Star the repo or open an issue to share your feedback!