vrr/awesome-opencode
2
0
Fork 0
mirror of https://github.com/awesome-opencode/awesome-opencode.git synced 2026-04-28 12:29:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
awesome-opencode/data/examples
History
Lucas Shamanic ce60a25d13
Simplify description format in theme.yaml
2026-01-15 11:52:21 +00:00
..
agent.yaml Refactor description in agent.yaml 2026-01-15 11:50:55 +00:00
fork.yaml Fix description formatting in fork.yaml 2026-01-15 11:33:53 +00:00
plugin.yaml Update plugin.yaml description formatting 2026-01-15 11:32:56 +00:00
project.yaml Fix description formatting in project.yaml 2026-01-15 11:51:59 +00:00
README.md refactor(examples): move example files to data/examples 2026-01-12 23:52:06 +00:00
resource.yaml Refactor description in resource.yaml 2026-01-15 11:51:48 +00:00
theme.yaml Simplify description format in theme.yaml 2026-01-15 11:52:21 +00:00

README.md

Examples

This directory contains exemplar YAML files showing the full schema for each extension type.

These are reference examples, not actual entries.

Usage

When adding a new entry to data/{category}/, use the corresponding example as a reference:

Adding to... Reference
data/plugins/ plugin.yaml
data/themes/ theme.yaml
data/agents/ agent.yaml
data/projects/ project.yaml
data/resources/ resource.yaml
data/forks/ fork.yaml

Required vs Optional Fields

Required (all entries must have)

  • name - Display name
  • repo - Repository URL (https://github.com/...)
  • tagline - Short description (max 120 chars)
  • description - Full description (can be multi-line)

Optional (include if relevant)

  • scope - Installation scope: [global], [project], or [global, project] (defaults to [global])
  • tags - Array of strings for filtering
  • min_version - Minimum OpenCode version (semver)
  • homepage - Documentation URL if different from repo
  • installation - Markdown installation instructions

Notes

  • Type is derived from directory - No type field needed; it's inferred from the folder
  • Scope is optional - Defaults to [global]; add if project-level install is relevant
  • Installation is markdown - Use headers, code blocks, lists as needed
  • Schema allows additional fields - Future fields can be added without breaking existing entries