Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

docs/skills: Catalogs index.json format does not match agent-skills-discovery-rfc 0.2.0

オープン 初心者向け
  • 何か問題がありますか？
#54,757 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
67/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
領域
documentation

調査の方向性

Skills のドキュメントを開き、Catalogs セクションとそこにある index.json の例を、引用されている RFC 0.2.0 スキーマとあわせて確認してください。ドキュメントでそのスキーマを採用するか、OpenCode の形式、バージョン管理、移行、互換性を説明するかを判断してください。ドキュメントで両者の関係が明確に説明され、正確なカタログ例が示されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Description

Issue type

  • Documentation bug
  • Schema / compatibility issue
  • Feature request

Summary

The index.json format shown in the Catalogs section of the OpenCode v2 Skills docs does not match the agent-skills-discovery-rfc 0.2.0 format.

OpenCode’s current example uses a skills array where each entry contains name, version, and files. The RFC 0.2.0 example uses a top-level $schema field and per-skill fields such as type, description, url, and digest.

This divergence may affect:

  • skill catalog interoperability
  • discovery and resolution logic
  • content integrity verification
  • compatibility with agents that follow the RFC

Affected pages

Expected behavior

The Catalogs documentation should either:

  1. align with the agent-skills-discovery-rfc 0.2.0 index.json schema, or
  2. explicitly document that OpenCode uses a different catalog format, including versioning, migration guidance, and compatibility expectations.

Actual behavior

The Catalogs section currently documents an index.json format that differs from the RFC 0.2.0 schema.

OpenCode example:

{
  "skills": [
    {
      "name": "git-release",
      "version": "3",
      "files": ["git-release.md", "references/release-policy.md"]
    }
  ]
}

RFC 0.2.0 example:

{
  " $ schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "code-review",
      "type": "skill-md",
      "description": "Review code for bugs, security issues, and best practices.",
      "url": "/.well-known/agent-skills/code-review/SKILL.md",
      "digest": "sha256:c4d5e6f7..."
    },
    {
      "name": "wrangler",
      "type": "archive",
      "description": "Deploy and manage Cloudflare Workers projects.",
      "url": "/.well-known/agent-skills/wrangler.tar.gz",
      "digest": "sha256:a1b2c3d4..."
    }
  ]
}

References
OpenCode Skills docs: https://opencode.ai/v2/docs/skills
Agent Skills Discovery RFC: https://github.com/cloudflare/agent-skills-discovery-rfc

Plugins

No response

OpenCode version

No response

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

No response

Terminal

No response

主要言語
TypeScript
スター
215k
フォーク
28.9k
平均マージ
8時間 27分
マージ済み PR（30日）
282

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

anomalyco/opencode のほかの issue

anomalyco/opencode の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。