OpenCode Skills ガイド：再利用できる AI 開発ワークフローの 7 ルール

OpenCode skills は、繰り返し発生する開発作業のための再利用可能な指示セットです。手順、ドメインルール、レビュー基準を OpenCode に安定して適用したいときに使います。秘密情報の置き場や agent、MCP の代替として使わないでください。 同じ指示を何度もプロンプトに書いているなら skill 化する価値があります。一回限りの注意はプロンプトに、永続的な好みは設定や README に置きます。

同じ指示を何度もプロンプトに書いているなら skill 化する価値があります。一回限りの注意はプロンプトに、永続的な好みは設定や README に置きます。

小さなタスクを skill あり・なしで比べるのが一番確実です。説明の繰り返しが減り diff が良くなるなら残します。

プロジェクト skill は対象コードの近くにあるためレビューしやすくなります。グローバル skill は別リポジトリにも影響するため、本当に共通の習慣だけに使います。

framework、デプロイ先、文章スタイル、コンプライアンスを含むなら、多くの場合はプロジェクト skill にします。

同じ指示を何度もプロンプトに書いているなら skill 化する価値があります。一回限りの注意はプロンプトに、永続的な好みは設定や README に置きます。

skill は振る舞いの指針、command は名前付きアクション、agent は役割と文脈の分離、MCP は外部ツール接続です。

プロジェクト skill は対象コードの近くにあるためレビューしやすくなります。グローバル skill は別リポジトリにも影響するため、本当に共通の習慣だけに使います。

skill は目的、トリガー、手順、制限、期待する証拠を持つ小さな契約として書きます。テストできないものは広すぎます。

同じ指示を何度もプロンプトに書いているなら skill 化する価値があります。一回限りの注意はプロンプトに、永続的な好みは設定や README に置きます。

まず最小テンプレートから始め、プレースホルダーを実際のリポジトリのコマンドに置き換えます。

---
name: repository-review
description: Use when reviewing code changes in this repository.
---

# Repository Review

1. Inspect the changed files and nearby tests before giving findings.
2. Prioritize bugs, regressions, security risks, and missing validation.
3. Run the documented test command when the touched area has one.
4. Report findings first with file and line references.
5. If no issue is found, say so and mention residual test risk.

プロジェクト skill は対象コードの近くにあるためレビューしやすくなります。グローバル skill は別リポジトリにも影響するため、本当に共通の習慣だけに使います。

秘密情報は環境変数、provider 認証、パスワード管理に置きます。skill は扱い方を説明するだけです。

同じ指示を何度もプロンプトに書いているなら skill 化する価値があります。一回限りの注意はプロンプトに、永続的な好みは設定や README に置きます。

結果が悪化したら、完全版、短縮版、通常プロンプトを比べます。重複した指示を見つけやすくなります。

AGENTS.md の規則を subagents に分ける前に、OpenCode agents ガイドで役割とツール境界を確認してください。 OpenCode agents ガイド.