From 0db5a3289eb41bc2a6466175fdab3e0f33406e2a Mon Sep 17 00:00:00 2001
From: Lucas Shamanic <90007349+ShamanicArts@users.noreply.github.com>
Date: Mon, 22 Sep 2025 02:52:05 +0100
Subject: [PATCH] Revise README for clarity and structure

---
 README.md | 39 ++++++++++++++++++++++++++++++---------
 1 file changed, 30 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index a406d42..4847bce 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,42 @@
+
 # awesome-opencode
 
-> A curated list of awesome opencode projects, themes, plugins, and resources.
+[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
+
+> A curated list of awesome plugins, themes, agents, projects, and resources for [OpenCode](https://opencode.ai/).
+
+[OpenCode](https://opencode.ai/) is an AI coding agent for the terminal, built by the team at [SST](https://github.com/sst). This list is a community-driven collection of resources to make it even more powerful.
 
 ## Contents
 
-- [Themes](#themes)
-- [Projects](#projects)
 - [Plugins](#plugins)
-- [Configuration Files](#configuration-files)
+- [Themes](#themes)
+- [Agents](#agents)
+- [Projects](#projects)
 - [Resources](#resources)
 
-## Themes
-
-## Projects
-
 ## Plugins
 
-## Configuration Files
+*Your contributions are welcome!*
+
+## Themes
+
+*Your contributions are welcome!*
+
+## Agents
+
+*Your contributions are welcome!*
+
+## Projects
+
+*Your contributions are welcome!*
 
 ## Resources
+
+*Your contributions are welcome!*
+
+## Contributing
+
+Your contributions are essential to keeping this list great!
+
+Please feel free to suggest new additions by **starting a new discussion** in the [Discussions tab](https://github.com/ShamanicArts/awesome-opencode/discussions) of this repository. We're looking for new projects, categories, and any other ideas to make this list better. Thank you for your help in building this community resource