opencode-swarm 7.195.0 → 7.197.0

package/.opencode/skills/brainstorm/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: brainstorm
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: BRAINSTORM -- structured discovery dialogue, approach selection, spec drafting, QA gate selection, and transition handling.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Brainstorm Protocol

package/.opencode/skills/ci-failure-batching/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: ci-failure-batching
-audience: swarm-plugin
 description: Batch collection and fix protocol for CI failures. Triggered when any CI check fails on a PR. Prevents serial diagnose-fix-push cycles by collecting all failures before fixing.
+metadata:
+  audience: swarm-plugin
 ---
 
 # CI Failure Batching

package/.opencode/skills/ci-fix-monitor/SKILL.md

@@ -1,10 +1,11 @@
 ---
 name: ci-fix-monitor
-audience: swarm-plugin
 description: >
   Monitor CI on a PR, diagnose failures, fix them, and re-push until green.
   Covers reading CI logs, classifying failure types (check-title, package-check,
   test failures, lint), determining the correct fix, and re-pushing.
+metadata:
+  audience: swarm-plugin
 ---
 
 # CI Fix & Monitor Protocol

package/.opencode/skills/clarify/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: clarify
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: CLARIFY -- structured clarification funnel with critic review before surfacing user decisions.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Clarify Protocol

package/.opencode/skills/clarify-spec/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: clarify-spec
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: CLARIFY-SPEC -- resolving spec clarification markers and maintaining spec/planning alignment.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Clarify Spec Protocol

package/.opencode/skills/codebase-review-swarm/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: codebase-review-swarm
-audience: swarm-plugin
 description: Run a rigorous, quote-grounded codebase review or security/QA/accessibility/performance/AI-slop/enhancement audit. Use for full-repo or large-subsystem review reports; not for normal implementation. Performs Phase 0 inventory, selected exhaustive tracks with non-diluting depth, coverage closure, reviewer/critic validation, and writes .swarm/review-v8 artifacts without modifying source files.
 license: MIT
 metadata:
@@ -8,6 +7,7 @@ metadata:
   generated: "2026-06-08"
   source_prompt: "codebase-review-swarm-prompt-v7"
   artifact_root: ".swarm/review-v8/runs/<run_id>/"
+  audience: swarm-plugin
 ---
 
 # Codebase Review Swarm

package/.opencode/skills/commit-pr/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: commit-pr
-audience: swarm-plugin
 description: >
   Apply when committing, pushing, opening or updating a pull request, or closing
   out CI. A portable, project-agnostic commit and PR workflow: verify before you
   push, write conventional commits and a clear PR body, and never commit
   generated or secret files.
-effort: medium
+metadata:
+  audience: swarm-plugin
+  effort: medium
 ---
 
 # Commit & PR Protocol (portable)

package/.opencode/skills/consult/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: consult
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: CONSULT -- answering advisory questions with bounded evidence and clear uncertainty.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Consult Protocol

package/.opencode/skills/council/SKILL.md

@@ -1,9 +1,10 @@
 ---
 name: council
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: COUNCIL -- General Council research,
   parallel member dispatch, disagreement handling, and synthesis.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Council Protocol

package/.opencode/skills/critic-gate/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: critic-gate
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: CRITIC-GATE -- plan critic review, revision loops, and hard stop before execution.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Critic Gate Protocol

package/.opencode/skills/deep-dive/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: deep-dive
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: DEEP_DIVE — read-only codebase audit with
   parallel explorer waves, 2 independent reviewers, and sequential critic
   challenge for HIGH/CRITICAL findings. Loaded on demand by the architect when
   the deep-dive command emits a [MODE: DEEP_DIVE ...] signal.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Deep Dive Audit Protocol

package/.opencode/skills/deep-research/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: deep-research
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: DEEP_RESEARCH — orchestrator-worker deep
   research over external sources: decompose, iterative web_search/web_fetch
   retrieval, parallel sme synthesis, dual-reviewer claim verification, critic
   challenge of high-stakes claims, and a cited report. Loaded on demand by the
   architect when the deep-research command emits a [MODE: DEEP_RESEARCH ...] signal.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Deep Research Protocol

package/.opencode/skills/design-docs/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: design-docs
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: DESIGN_DOCS — generate or sync structured,
   language-agnostic design docs (domain.md, technical-spec.md, behavior-spec.md,
   reference/) for the project under build, with a stable section-ID registry and
   a design changelog. Loaded on demand by the architect when the design-docs
   command emits a [MODE: DESIGN_DOCS ...] signal (issue #1080).
+metadata:
+  audience: swarm-plugin
 ---
 
 # Design-Doc Generation & Sync Protocol

package/.opencode/skills/discover/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: discover
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: DISCOVER -- read-only repository discovery and governance/context mapping.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Discover Protocol

package/.opencode/skills/durable-session-state/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: durable-session-state
-audience: swarm-plugin
 description: >
   Persist plans, scope decisions, evidence, and reviewer/critic verdicts to
   durable files during long or multi-phase tasks so work survives context
   compaction, session resumes, and handoffs. Use for swarm-mode tasks, before
   context grows large, when recording approval gates, and when resuming after
   compaction or a session restart.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Durable Session State

package/.opencode/skills/engineering-conventions/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: engineering-conventions
-audience: swarm-plugin
 description: >
   Guidelines and non-negotiable engineering invariants for modifying opencode-swarm.
   Load before architecture, plugin initialization, subprocess, tool registration, plan
   durability, .swarm storage, runtime portability, session/global state, guardrails/retry,
   chat/system message hooks, or release/cache changes. Authoritative source: AGENTS.md
   at the repo root and docs/engineering-invariants.md.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Engineering Conventions for opencode-swarm

package/.opencode/skills/execute/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: execute
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: EXECUTE -- task execution, coder retry handling, QA gates, completion evidence, and per-task closure.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Execute Protocol

package/.opencode/skills/fork-pr-operations/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: fork-pr-operations
-audience: swarm-plugin
 description: Operational patterns for fork PRs (head repo differs from base repo). Covers GitHub workflow approval after push, force-push protocol, remote naming conventions, stale CI verification, and bot review multi-round awareness. Load when working with fork PRs, cross-repo contributions, or workflow approval issues.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Fork PR Operations

package/.opencode/skills/gate-attribution/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: gate-attribution
-audience: swarm-plugin
 description: Per-task gate dispatch protocol for reviewer/test_engineer set-dispatch attribution. Activates when dispatch_lanes returns set-dispatch verdict rows that must be attributed to plan tasks. Documents single-task attribution plus parseable set-dispatch reviewer/test_engineer rows.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Gate Attribution

package/.opencode/skills/issue-ingest/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: issue-ingest
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: ISSUE_INGEST -- GitHub issue intake, localization, spec generation, and transition to the full fix workflow.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Issue Ingest Protocol

package/.opencode/skills/issue-tracer/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: issue-tracer
-audience: swarm-plugin
 description: Evidence-first investigation, validation, and full resolution of issues and bugs. Use when asked to investigate, trace, root-cause, reproduce, plan, fix, resolve, close, or prepare a PR for an issue, bug report, defect, regression, failing test, crash, or confusing runtime behavior. Drives issue validation, acceptance-check-driven reproduction and fix planning, independent critic and implementation review, recurrence-class eradication, and an invariant-aware, PR-ready closure with a recorded human merge gate under a mandatory full-resolution contract that forbids partial fixes, deferred work, and unwired code.
 license: MIT
 metadata:
   version: 3.0.0
   source: .opencode/skills/issue-tracer/SKILL.md
+  audience: swarm-plugin
 ---
 
 # Issue Tracer

package/.opencode/skills/loop/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: loop
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: LOOP — the compound-engineering loop:
   brainstorm → plan → build → review → improve, iterating under
@@ -8,6 +7,8 @@ description: >
   durable resumable state, and mandatory compounding learning capture.
   Loaded on demand by the architect when the loop command emits a
   [MODE: LOOP ...] signal.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Compound-Engineering Loop Protocol

package/.opencode/skills/merge-queue-readiness/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: merge-queue-readiness
-audience: swarm-plugin
 description: Pre-queue merge-group CI simulation. Triggered before adding a PR to a GitHub merge queue. Prevents merge-queue kick-outs from integration test failures.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Merge Queue Readiness

package/.opencode/skills/orchestrating-subagents/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: orchestrating-subagents
-audience: swarm-plugin
 description: >
   Tiering and economics for delegating to subagents: which agent type, model,
   and effort to use per role (explorer, implementer, reviewer, critic), how many
@@ -8,6 +7,8 @@ description: >
   bounded structured returns, and how to keep the main context clean. Use when
   launching subagents, parallel explorers, independent reviewers, or critic
   passes — especially for swarm-mode, qa-sweep, or issue-tracer work.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Orchestrating Subagents

package/.opencode/skills/parallel-work-check/SKILL.md

@@ -1,25 +1,26 @@
 ---
 name: parallel-work-check
-audience: swarm-plugin
 description: >
   Apply before starting work on an existing branch. Checks for parallel work by
   other agents or developers that may supersede or conflict with your planned
   changes. Prevents wasted effort on stale branches.
-effort: small
-generated_from_knowledge: []
-source_knowledge_ids: ['f07c1f4d-9bb0-4219-9804-26aa8efe8146']
-generated_at: 2026-06-14T16:50:00Z
-confidence: 0.8
-status: active
-version: 4
-skill_origin: generated
-provenance_note: >
-  Re-linked to current knowledge entries (version 4). The original source ID
-  b8fee776... is no longer present in the active knowledge store. The skill
-  body and behavior are unchanged; only source_knowledge_ids metadata was
-  updated to point to the current lesson about verifying pre-existing state
-  on parent commit, which is directly relevant to the parallel-work-check
-  protocol.
+metadata:
+  audience: swarm-plugin
+  effort: small
+  generated_from_knowledge: '[]'
+  source_knowledge_ids: '["f07c1f4d-9bb0-4219-9804-26aa8efe8146"]'
+  generated_at: "2026-06-14T16:50:00Z"
+  confidence: "0.8"
+  status: active
+  version: "4"
+  skill_origin: generated
+  provenance_note: >
+    Re-linked to current knowledge entries (version 4). The original source ID
+    b8fee776... is no longer present in the active knowledge store. The skill
+    body and behavior are unchanged; only source_knowledge_ids metadata was
+    updated to point to the current lesson about verifying pre-existing state
+    on parent commit, which is directly relevant to the parallel-work-check
+    protocol.
 ---
 
 # Parallel Work Check Protocol

package/.opencode/skills/phase-wrap/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: phase-wrap
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: PHASE-WRAP -- phase boundary evidence, drift and hallucination gates, retrospectives, phase completion, and final council.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Phase Wrap Protocol

package/.opencode/skills/pre-phase-briefing/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: pre-phase-briefing
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: PRE-PHASE BRIEFING -- phase-start context assembly, evidence review, and task readiness checks.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Pre Phase Briefing Protocol

package/.opencode/skills/running-tests/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: running-tests
-audience: swarm-plugin
 description: >
   Safe test execution patterns for opencode-swarm. Covers when to use the test_runner
   tool vs shell bun commands, scope safety rules, per-file isolation loops (bash and
   PowerShell), pre-existing failure verification, CI log reading, and failure
   classification. Load this skill when you need to run tests — not when you need to
   write them (see writing-tests for authoring guidance).
+metadata:
+  audience: swarm-plugin
 ---
 
 # Running Tests for opencode-swarm

package/.opencode/skills/skill-edit-validation/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: skill-edit-validation
-audience: swarm-plugin
 description: Content-assertion sweep after editing SKILL.md files. Triggered when a task changes skill or prompt content that tests assert against. Prevents stale-assertion CI failures.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Skill Edit Validation

package/.opencode/skills/specify/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: specify
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: SPECIFY -- spec creation, codebase reality checks, SME input, QA gate persistence, and optional council spec review.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Specify Protocol

package/.opencode/skills/swarm/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: swarm
-audience: swarm-plugin
 description: Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate. Runtime adapters (.claude, .agents) add execution-specific notes and command wiring.
+metadata:
+  audience: swarm-plugin
 ---
 
 ## Goal

package/.opencode/skills/swarm-ci-monitor/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: swarm-ci-monitor
-audience: swarm-plugin
 description: >
   End-to-end CI monitor that takes an already-human-reviewed PR, exhaustively
   researches every CI failure, fixes it end-to-end, iterates until all required
@@ -9,7 +8,9 @@ description: >
   failure-type-specific fix recipes. This is the first skill in the repo that
   executes a merge — invoke it deliberately.
 disable-model-invocation: true
-swarm-contract-digest: c1572cc54760
+metadata:
+  audience: swarm-plugin
+  swarm-contract-digest: c1572cc54760
 ---
 
 # Swarm CI Monitor

package/.opencode/skills/swarm-implement/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: swarm-implement
-audience: swarm-plugin
 description: Execute complex implementation work with a swarm-like workflow: parallel exploration, scoped planning, objective validation, mandatory independent implementation review for changed work, and final critic approval. Use for feature work, bug fixes, refactors, and multi-file changes.
 disable-model-invocation: true
+metadata:
+  audience: swarm-plugin
 ---
 
 # /swarm-implement

package/.opencode/skills/swarm-plan/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: swarm-plan
-audience: swarm-plugin
 description: >
   Full execution protocol for MODE: PLAN -- plan creation, external plan ingestion, QA gate persistence, task granularity, and traceability checks.
+metadata:
+  audience: swarm-plugin
 ---
 
 # Plan Protocol