Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#54,757 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
67/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Ambito
documentation

Direzione di ricerca

Apri la documentazione di Skills e consulta la sezione Catalogs e il relativo esempio di index.json, insieme allo schema RFC 0.2.0 citato. Decidi se la documentazione debba adottare quello schema o spiegare il formato, la gestione delle versioni, la migrazione e la compatibilità di OpenCode. Il lavoro è concluso quando la documentazione descrive chiaramente la relazione e mostra un esempio di catalogo corretto.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
TypeScript
Stelle
213k
Fork
28.4k
Merge medio
7h 50m
PR unite (30g)
295

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di anomalyco/opencode

Tutte le issue di anomalyco/opencode

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.