Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#54,757 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
67/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

Mở tài liệu Skills và xem mục Catalogs cùng ví dụ index.json trong đó, đối chiếu với lược đồ RFC 0.2.0 được trích dẫn. Quyết định xem tài liệu nên áp dụng lược đồ đó hay giải thích định dạng, cách quản lý phiên bản, quá trình di chuyển và khả năng tương thích của OpenCode. Hoàn thành khi tài liệu mô tả rõ mối quan hệ này và đưa ra ví dụ danh mục chính xác.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
TypeScript
Star
213k
Fork
28.4k
Merge trung bình
8 giờ 32 phút
Pull request đã merge (30 ngày)
253

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của anomalyco/opencode

Tất cả issue của anomalyco/opencode

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.