Add marketplace website for AI Helpers plugins

Adds a comprehensive marketplace website to showcase all plugins, commands,
and skills in the ai-helpers repository:

- Interactive plugin browser with search functionality
- Linkable install instructions and plugin details
- Copy-to-clipboard install commands for each plugin
- Responsive design with dark theme
- Auto-generated from plugin metadata via `make update`
- Updated linter to verify docs/data.json stays in sync

The website is served from docs/ for GitHub Pages deployment.

Co-Authored-By: Claude <[email protected]>

Author: 2 people

.claudelint-custom.py

@@ -15,15 +15,15 @@
 
 
 class PluginsDocUpToDateRule(Rule):
-    """Check that PLUGINS.md is up-to-date by running 'make update'"""
+    """Check that PLUGINS.md and docs/data.json are up-to-date by running 'make update'"""
 
     @property
     def rule_id(self) -> str:
         return "plugins-doc-up-to-date"
 
     @property
     def description(self) -> str:
-        return "PLUGINS.md must be up-to-date with plugin metadata. Run 'make update' to regenerate."
+        return "PLUGINS.md and docs/data.json must be up-to-date with plugin metadata. Run 'make update' to regenerate."
 
     def default_severity(self) -> Severity:
         return Severity.ERROR
@@ -36,6 +36,8 @@ def check(self, context: RepositoryContext) -> List[RuleViolation]:
             return violations
 
         plugins_md_path = context.root_path / "PLUGINS.md"
+        data_json_path = context.root_path / "docs" / "data.json"
+
         if not plugins_md_path.exists():
             return violations
 
@@ -45,8 +47,9 @@ def check(self, context: RepositoryContext) -> List[RuleViolation]:
             return violations
 
         try:
-            # Read current PLUGINS.md content
-            original_content = plugins_md_path.read_text()
+            # Read current content of files to check
+            original_plugins_md = plugins_md_path.read_text()
+            original_data_json = data_json_path.read_text() if data_json_path.exists() else None
 
             # Run the docs generation script
             result = subprocess.run(
@@ -66,13 +69,31 @@ def check(self, context: RepositoryContext) -> List[RuleViolation]:
                 )
                 return violations
 
-            # Read the generated PLUGINS.md content
-            generated_content = plugins_md_path.read_text()
+            # Also run build-website.py if it exists
+            website_script_path = context.root_path / "scripts" / "build-website.py"
+            if website_script_path.exists():
+                result = subprocess.run(
+                    ["python3", str(website_script_path)],
+                    cwd=str(context.root_path),
+                    capture_output=True,
+                    text=True,
+                    timeout=30
+                )
+
+                if result.returncode != 0:
+                    violations.append(
+                        self.violation(
+                            f"build-website.py failed: {result.stderr}",
+                            file_path=data_json_path if data_json_path.exists() else plugins_md_path
+                        )
+                    )
+                    return violations
 
-            # Compare
-            if original_content != generated_content:
+            # Check if PLUGINS.md changed
+            generated_plugins_md = plugins_md_path.read_text()
+            if original_plugins_md != generated_plugins_md:
                 # Restore original content
-                plugins_md_path.write_text(original_content)
+                plugins_md_path.write_text(original_plugins_md)
 
                 violations.append(
                     self.violation(
@@ -81,6 +102,21 @@ def check(self, context: RepositoryContext) -> List[RuleViolation]:
                     )
                 )
 
+            # Check if docs/data.json changed
+            if data_json_path.exists():
+                generated_data_json = data_json_path.read_text()
+                if original_data_json != generated_data_json:
+                    # Restore original content
+                    if original_data_json is not None:
+                        data_json_path.write_text(original_data_json)
+
+                    violations.append(
+                        self.violation(
+                            "docs/data.json is out of sync with plugin metadata. Run 'make update' to update.",
+                            file_path=data_json_path
+                        )
+                    )
+
         except subprocess.TimeoutExpired:
             violations.append(
                 self.violation(
@@ -91,7 +127,7 @@ def check(self, context: RepositoryContext) -> List[RuleViolation]:
         except Exception as e:
             violations.append(
                 self.violation(
-                    f"Error checking PLUGINS.md up-to-date status: {e}",
+                    f"Error checking files up-to-date status: {e}",
                     file_path=plugins_md_path
                 )
             )

Makefile

@@ -22,9 +22,11 @@ lint-pull: ## Pull the latest claudelint image
 	$(CONTAINER_RUNTIME) pull $(CLAUDELINT_IMAGE)
 
 .PHONY: update
-update: ## Update plugin documentation in PLUGINS.md
+update: ## Update plugin documentation and website data
 	@echo "Updating plugin documentation..."
 	@python3 scripts/generate_plugin_docs.py
+	@echo "Building website data..."
+	@python3 scripts/build-website.py
 
 .DEFAULT_GOAL := help
 

docs/.nojekyll

@@ -0,0 +1,56 @@
+# AI Helpers Website
+
+This directory contains the GitHub Pages website for the ai-helpers project.
+
+## Structure
+
+- `index.html` - Main website with plugin browser
+- `data.json` - Plugin and command metadata (generated)
+- `.nojekyll` - Tells GitHub Pages not to use Jekyll processing
+
+## Building
+
+The website data is generated from the repository structure:
+
+```bash
+# From repository root
+python3 scripts/build-website.py
+```
+
+This extracts information from:
+- `.claude-plugin/marketplace.json` - Plugin registry
+- `plugins/*/commands/*.md` - Command definitions
+- `plugins/*/skills/*/SKILL.md` - Skill definitions
+- `plugins/*/.claude-plugin/plugin.json` - Plugin metadata
+
+## Local Development
+
+To test the website locally:
+
+```bash
+cd docs
+python3 -m http.server 8000
+# Visit http://localhost:8000
+```
+
+## Deployment
+
+The website is automatically deployed via GitHub Pages from the `docs/` directory.
+
+To enable GitHub Pages:
+1. Go to repository Settings > Pages
+2. Set Source to "Deploy from a branch"
+3. Select branch (e.g., `main`) and `/docs` folder
+4. Save
+
+The site will be available at: `https://openshift-eng.github.io/ai-helpers/`
+
+## Updating
+
+When plugins or commands are added/modified:
+
+1. Run `python3 scripts/build-website.py` to regenerate `data.json`
+2. Commit both `data.json` and any changes
+3. Push to trigger GitHub Pages rebuild
+
+Alternatively, set up a GitHub Action to automatically rebuild on changes.