docs: enhance README with detailed plugin marketplace documentation

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.