oc-update-skill

Update OpenCode Skill

You are initiating the OpenCode skill update workflow. This process locates an existing skill, researches current platform best practices, analyzes the skill for outdated patterns, and applies updates with validation.

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.

---

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

---

Phase 2: Locate Skill

Find the skill to update.

If $ARGUMENTS is provided:

1. Check if the argument is a file path — read it directly
2. If it's a skill name — search for it in known discovery paths

If no arguments:

1. Search for OpenCode skills in the workspace:
   • Glob for .opencode/skills/*/SKILL.md
   • Glob for .claude/skills/*/SKILL.md
   • Glob for .agents/skills/*/SKILL.md
2. Present found skills using AskUserQuestion:
   • Header: "Select Skill"
   • Question: "Which skill would you like to update?"
   • Options: List found skills (up to 4; include "Other" for custom path)

Read the selected skill file and store its contents.

---

Phase 3: Research

Spawn the researcher agent to check latest OpenCode documentation:

Task:
  subagent_type: "agent-alchemy-opencode-tools:oc-researcher"
  prompt: |
    Research the latest OpenCode documentation for skill format compatibility.

    Artifact type: skill
    Current artifact content:
    ---
    {contents of the skill file}
    ---

    Specific questions:
    1. Are there any new skill frontmatter fields since v1.2.10?
    2. Have any existing fields been deprecated?
    3. Are there new best practices for skill body structure?
    4. Any changes to $VARIABLE placeholder handling?

    Reference guide: ${CLAUDE_PLUGIN_ROOT}/references/skill-guide.md