Summary

• Replace Hive's custom hive_skill surface with OpenCode's native skill tool.
• Materialize bundled Hive skills into a generated native-skill directory and register that path with OpenCode.
• Keep autoLoadSkills, but resolve native/user skills first and bundled Hive skills second.
• Remove the old file-skill fallback and document the native SKILL.md frontmatter contract.

Behavior

• Hive bundled skills are now normal OpenCode-discovered skills.
• autoLoadSkills injects either native discovered skills or eligible bundled Hive skills into agent prompts.
• Skill identity is SKILL.md frontmatter name, not the directory name.
• Native/user skills shadow bundled Hive skills with the same name.
• disableSkills only disables bundled Hive skills. It does not block native/user skills.
• If skills.urls cannot be scanned, bundled Hive skill materialization/autoload is skipped for that run. Local native skills can still load.
• If OpenCode resolves the worktree as /, generated Hive skills go under the OpenCode config directory instead of /.hive.
• Bundled skills that reference Hive tools now say Agent Hive in their native descriptions. General skills keep general descriptions.

Notable Changes

• Added native materialization and discovery handling in packages/opencode-hive/src/skills/native-materializer.ts.
• Wired generated skill paths and native-first autoload into the OpenCode config hook.
• Removed packages/opencode-hive/src/skills/file-loader.ts and the old hive_skill plugin tool surface.
• Updated prompts, permissions, generated skill registry, docs, schema text, and tests for native skill loading.
• Scoped native skill descriptions only for skills that reference Hive tools or commands, so non-Hive agents get clearer selection signals.
• Added a safe generated-skill location for root-resolved sessions: ~/.config/opencode/agent-hive/generated/opencode-skills/<hash> or the configured OpenCode config dir equivalent.
• Fixed the root build script to use @tctinh/agent-hive-mcp instead of the stale hive-mcp workspace filter.

Testing

• cd packages/hive-core && bun test -> 238 pass, 0 fail
• cd packages/opencode-hive && bun test -> 475 pass, 0 fail
• cd packages/opencode-hive && XDG_CONFIG_HOME=/tmp/ci-xdg-config bun test -- src/skills/native-materializer.test.ts -> 26 pass, 0 fail
• cd packages/opencode-hive && bun test -- src/skills/skill-content.test.ts -> 6 pass, 0 fail
• bun run build -> PASS (exit 0)
• bun run test -> PASS (exit 0)

Smoke Test: Bundled Hive Skill

Use this with hive-master on this branch:

Smoke test native Hive skill loading.

From your current system prompt and available tool list only, answer:

parallel-exploration content: present|missing
first heading: <heading or n/a>
hive_skill tool: present|absent
native skill tool: present|absent

Expected:

parallel-exploration content: present
first heading: # Parallel Exploration (Scout Fan-Out)
hive_skill tool: absent
native skill tool: present

This checks that a Hive-bundled skill which used to rely on hive_skill is now exposed through native skill registration and prompt autoload.

Smoke Test: Native User Skill

Create this file:

<project>/.opencode/skills/diagnostic/SKILL.md

---
name: diagnostic-skill
description: Diagnostic skill for native autoload verification
---
# Diagnostic Skill

This content should be visible in the agent system prompt.

Configure:

{
  "agents": {
    "hive-master": {
      "autoLoadSkills": ["diagnostic-skill"]
    }
  }
}

Ask hive-master:

Inspect your current system prompt. Do you see the heading "Diagnostic Skill"? Answer only "present" or "missing".

Expected: present.

Will have conflict after #94 will rebase after that merges