Skill Creator

Skill creator helps create other skills that are self-buildable.

The best way to use it is after a user already executed a flow and says: create a skill for this. Alternatively, if the user asks for a skill to be created, suggest they do the task first and ask for skill creation at the end.

This should trigger this scaffold:

• If the user needed to configure things, create a .env.example without credentials and include all required variables.
• Ask the user if they want to store credentials. If yes, write them to a .env file in the skill, and suggest rotating keys later.
• Always add a .gitignore in the skill that ignores .env, and verify .env is not tracked.
• If the user needed to interact with an API and you created scripts, add reusable scripts under scripts/.
• New skills should explain how to use the scripts/ and that .env.example defines the minimum config.
• Skills should state that they infer what they can do from the available config.

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

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

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

Quick Usage (Already Configured)

Create a new skill folder

mkdir -p .opencode/skills/<skill-name>

Minimum scaffold files

• SKILL.md
• scripts/
• .env
• .env.example (use this to guide the minimum config)
• .gitignore (ignore .env)

.env (credentials + config)

• Use .env.example to document required credentials or external setup.
• Do not include any real credentials in .env.example.

Minimal skill template

---
name: skill-name
description: One-line description
---

## Quick Usage (Already Configured)

### Action 1

command here

## Common Gotchas

- Thing that doesn't work as expected

## First-Time Setup (If Not Configured)

1. ...

Notes from OpenCode docs

• Skill folders live in .opencode/skills/<name>/SKILL.md.
• name must be lowercase and match the folder.
• Frontmatter requires name and description.

Reference

Follow the official OpenCode skills docs: https://opencode.ai/docs/skills/