oc-create-skill

Create OpenCode Skill

You are initiating the OpenCode skill creation workflow. This process guides the user through an interactive interview to gather requirements, generates a properly formatted SKILL.md file, and validates the result.

Critical Rules

AskUserQuestion is MANDATORY

IMPORTANT: You MUST use the AskUserQuestion tool for ALL questions to the user. Never ask questions through regular text output.

• Every interview question → AskUserQuestion
• Confirmation questions → AskUserQuestion
• Clarifying questions → AskUserQuestion

Text output should only be used for summaries, explanations, and presenting information.

---

Phase 1: Load References

Read the OpenCode platform overview and skill guide:

1. Read ${CLAUDE_PLUGIN_ROOT}/references/platform-overview.md
2. Read ${CLAUDE_PLUGIN_ROOT}/references/skill-guide.md

Store the reference content internally for use throughout the workflow.

---

Phase 2: Interview

Gather requirements through a structured interview using AskUserQuestion.

Round 1: Basics

Ask these questions using AskUserQuestion (max 4 per call):

Question 1 — Skill Name:

• Header: "Skill Name"
• Question: "What should this skill be named? Use kebab-case (e.g., code-review, deploy-check)."
• Options:
  • "I'll type the name" — Let me provide a custom name

Question 2 — Purpose:

• Header: "Purpose"
• Question: "What does this skill do? Describe its main function."
• Options:
  • "Code analysis" — Analyzes code for patterns, issues, or quality
  • "Workflow automation" — Automates a multi-step process
  • "Content generation" — Generates code, docs, or other content

Question 3 — User-Invocable:

• Header: "Invocable"
• Question: "Should users be able to invoke this skill directly (via /skill-name)?"
• Options:
  • "Yes (Recommended)" — Users can invoke it from the command dialog
  • "No" — Helper skill only loaded by other skills
• multiSelect: false

Round 2: Details

Question 1 — Target Audience:

• Header: "Audience"
• Question: "Who is the primary user of this skill?"
• Options:
  • "Developers" — Software developers working on code
  • "DevOps/SRE" — Operations and reliability engineers
  • "All users" — General-purpose, no specific expertise needed