AgentSkillsCN

skill-creator

有效技能创建指南。当用户希望创建或更新一项技能，以通过专业知识、工作流或工具集成来扩展 OpenCode 时，请使用本指南。

SKILL.md
--- frontmatter
name: skill-creator
description: Guide for creating effective skills. Use when users want to create
  or update a skill that extends OpenCode with specialized knowledge, workflows,
  or tool integrations.

Skill Creator

This skill is a template + checklist for creating skills in a workspace.

What is a skill?

A skill is a folder under .opencode/skills/<skill-name>/ or .claude/skills/<skill-name>/ anchored by SKILL.md.

Design goals

  • •Portable: safe to copy between machines
  • •Reconstructable: can recreate any required local state
  • •Self-building: can bootstrap its own config/state
  • •Credential-safe: no secrets committed; graceful first-time setup

Recommended structure

code
.opencode/
  skills/
    my-skill/
      SKILL.md
      README.md
      templates/
      scripts/

Trigger phrases (critical)

The description field is how Claude decides when to use your skill. Include 2-3 specific phrases that should trigger it.

Bad example: "Use when working with content"

Good examples: "Use when user mentions 'content pipeline', 'add to content database', or 'schedule a post'" "Triggers on: 'rotate PDF', 'flip PDF pages', 'change PDF orientation'"

Quick validation:

  • •Contains at least one quoted phrase
  • •Uses "when" or "triggers"
  • •Longer than ~50 characters

Frontmatter template

yaml
---
name: my-skill
description: |
  [What it does in one sentence]

  Triggers when user mentions:
  - "[specific phrase 1]"
  - "[specific phrase 2]"
  - "[specific phrase 3]"
---

Authoring checklist

  1. •Start with a clear purpose statement: when to use it + what it outputs.
  2. •Specify inputs/outputs and any required permissions.
  3. •Include “Setup” steps if the skill needs local tooling.
  4. •Add examples: at least 2 realistic user prompts.
  5. •Keep it safe: avoid destructive defaults; ask for confirmation.