refactor: move plugin manifest to repository root per Claude Code best practices

- Move plugin.json from skills/unraid/.claude-plugin/ to .claude-plugin/
- Update validation script to use correct plugin manifest path
- Add plugin structure section to root README.md
- Add installation instructions to skills/unraid/README.md
- Aligns with Claude Code's expectation for source: './' in marketplace.json

README.md

@@ -93,6 +93,27 @@ uv run unraid-mcp-server
 
 ---
 
+## 📂 Plugin Structure
+
+This repository is a Claude Code plugin. Key components:
+
+```
+unraid-mcp/                      # ${CLAUDE_PLUGIN_ROOT}
+├── .claude-plugin/
+│   ├── marketplace.json         # Marketplace catalog
+│   └── plugin.json              # Plugin manifest
+├── unraid_mcp/                  # MCP server Python package
+├── skills/unraid/               # Skill and documentation
+├── pyproject.toml               # Dependencies and entry points
+└── scripts/                     # Validation and helper scripts
+```
+
+- **MCP Server**: 10 tools with 90 actions via GraphQL API
+- **Skill**: `/unraid` skill for monitoring and queries
+- **Entry Point**: `unraid-mcp-server` defined in pyproject.toml
+
+---
+
 ## 📦 Installation
 
 ### 🐳 Docker Deployment (Recommended)

scripts/validate-marketplace.sh

@@ -41,10 +41,10 @@ check "Marketplace has name" "jq -e '.name' .claude-plugin/marketplace.json"
 check "Marketplace has plugins array" "jq -e '.plugins | type == \"array\"' .claude-plugin/marketplace.json"
 
 # Check plugin manifest
-check "Plugin manifest exists" "test -f skills/unraid/.claude-plugin/plugin.json"
+check "Plugin manifest exists" "test -f .claude-plugin/plugin.json"
-check "Plugin manifest is valid JSON" "jq empty skills/unraid/.claude-plugin/plugin.json"
+check "Plugin manifest is valid JSON" "jq empty .claude-plugin/plugin.json"
-check "Plugin has name" "jq -e '.name' skills/unraid/.claude-plugin/plugin.json"
+check "Plugin has name" "jq -e '.name' .claude-plugin/plugin.json"
-check "Plugin has version" "jq -e '.version' skills/unraid/.claude-plugin/plugin.json"
+check "Plugin has version" "jq -e '.version' .claude-plugin/plugin.json"
 
 # Check plugin structure
 check "Plugin has SKILL.md" "test -f skills/unraid/SKILL.md"

skills/unraid/README.md

@@ -23,6 +23,17 @@ skills/unraid/
     └── quick-reference.md            # Common queries cheat sheet
 ```
 
+## Installation
+
+This skill is part of the Unraid MCP plugin. Install via the Claude Code marketplace:
+
+```bash
+/plugin marketplace add jmagar/unraid-mcp
+/plugin install unraid @unraid-mcp
+```
+
+The plugin includes both the MCP server and this skill at `skills/unraid/`.
+
 ## Quick Start
 
 1. **Set your credentials:**