Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#54,757 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
67/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Área
documentation

Línea de trabajo

Abre la documentación de Skills y revisa la sección Catalogs y su ejemplo de index.json junto con el esquema RFC 0.2.0 citado. Decide si la documentación debería adoptar ese esquema o explicar el formato, el versionado, la migración y la compatibilidad de OpenCode. La tarea estará terminada cuando la documentación describa claramente la relación y muestre un ejemplo de catálogo correcto.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
TypeScript
Estrellas
213k
Forks
28.4k
Merge medio
7 h 22 min
PR fusionados (30 d)
276

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de anomalyco/opencode

Todos los issues de anomalyco/opencode

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.