Awesome-omni-skill skill-creator

Specialized skill for creating new OpenCode agent skills. Detailed instructions on triggers, structure, and best practices. Triggers: 'create a skill', 'make a new skill', 'add a skill', 'new skill'.

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/skill-creator-tobiasbak" ~/.claude/skills/diegosouzapw-awesome-omni-skill-skill-creator-503f80 && rm -rf "$T"
manifest: skills/data-ai/skill-creator-tobiasbak/SKILL.md
source content

skill-creator

This skill guides you through creating high-quality, reusable OpenCode agent skills.

Best Practices

  1. Naming: Use
    lowercase-alphanumeric-with-hyphens
    . The name MUST match the directory name.
  2. Description & Triggers:
    • Be precise. The agent uses this description to decide when to load the skill.
    • CRITICAL: Always include common "catchphrases" or triggers in the description to help the agent identify when to use the skill.
    • Example description: "Skill for analyzing logs. Triggers: 'check the logs', 'what happened in the logs', 'analyze errors'."
  3. Frontmatter: Always include
    name
    and
    description
    .
    license
    and
    compatibility
    are recommended.

... (rest of best practices)

Steps to Create a Skill

  1. Identify the behavior: Define exactly what reusable logic you want to encapsulate.

  2. Fetch Documentation: Use the

    webfetch
    tool to read
    https://opencode.ai/docs/skills/
    to ensure the skill is created using the most up-to-date syntax and rules.

  3. Determine Location: Use the

    question
    tool to ask the user if the skill should be created locally (project-level) or globally (user-level).

    • Local:
      .opencode/skill/
      or
      .claude/skills/
      (default to
      .claude/skills/
      if the project uses it).
    • Global:
      ~/.config/opencode/skill/
      or
      ~/.claude/skills/
      (default to
      ~/.claude/skills/
      ).
  4. Scaffold:

    • Create the skill directory in the chosen location.
    • Create a
      references/
      subfolder if complex documentation is needed.
  5. Initialize: Use the

    SKILL_TEMPLATE.md
    to create the new
    SKILL.md
    .

  6. Draft Instructions: Write the "how-to" for the agent. Use headers for clarity (e.g.,

    ## Steps
    ,
    ## Guidelines
    ).

  7. Verify: Ensure the frontmatter follows YAML standards and the name follows the regex

    ^[a-z0-9]+(-[a-z0-9]+)*$
    .

Templates

Use the standard template from this skill's

references/
directory as a base.