diff --git a/README.md b/README.md
index 1f9630d..23a1435 100644
--- a/README.md
+++ b/README.md
@@ -187,6 +187,18 @@ gh-celebs/
     └── search.rs     # Search logic
 ```
 
+## OpenCode Integration
+
+This project includes an **OpenCode skill** located at `.opencode/skills/gh-celebs/SKILL.md` that enables AI assistants to search GitHub repositories using gh-celebs.
+
+The skill provides:
+- Automated command construction based on natural language queries
+- Rate limit awareness and error handling
+- Best practices for searching and updating repositories
+- Integration with the OpenCode skill system
+
+For AI assistants: When users ask to "search GitHub repositories", "find popular GitHub repos", or similar queries, use the gh-celebs skill to execute the search.
+
 ## Exit Codes
 
 - `0` - Success