From b88b312515460f203fc553a75550e46886ccab91 Mon Sep 17 00:00:00 2001
From: Juan Puelpan <juan@puelpan.com>
Date: Fri, 17 Oct 2025 12:26:50 -0300
Subject: [PATCH] docs: enhance README with detailed plugin marketplace
 documentation

---
 README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 51 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3b0212f..4fff652 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,52 @@
-# Claude code plugins
+# Claude Code Plugin Marketplace
 
-A collection of personal plugin that I use for claude code
+A curated collection of Claude Code plugins designed to streamline development
+workflows with enhanced Git, GitHub, and project management capabilities.
+
+## Available Plugins
+
+### Development Plugin
+
+Provides slash commands to ease the development process with GitHub integration:
+
+- `/create-plan` - Generate structured development plans
+- `/execute-plan` - Execute planned development tasks
+- `/commit` - Smart commit creation with context
+- `/create-pr` - Create pull requests with AI-generated descriptions
+- `/pr-review` - Review pull requests with detailed analysis
+
+## Installation
+
+### Add Marketplace
+
+```bash
+/plugin marketplace add puelpan/claude-plugins
+```
+
+### Browse Available Plugins
+
+```bash
+/plugin marketplace list
+```
+
+### Install a Plugin
+
+```bash
+/plugin install development
+```
+
+## Usage
+
+Once installed, plugins provide custom slash commands that can be invoked
+directly in Claude Code:
+
+```bash
+/create-plan    # Start planning your feature
+/commit         # Create a contextual commit
+/create-pr      # Generate and create a PR
+```
+
+## Contributing
+
+This is a personal marketplace, but feel free to fork and create your own plugin
+collections.