ezai-marketplace 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
+  "name": "ezai-marketplace",
+  "version": "1.0.0",
+  "description": "Curated marketplace of AI skills for senior developers (Python / JS/TS)",
+  "owner": {
+    "name": "ezai",
+    "email": "floriansalort@gmail.com"
+  },
+  "updatedAt": "2026-05-28",
+  "plugins": [
+    {
+      "name": "ezai-code-formatter",
+      "description": "Apply source file visual structure to match project conventions: section header comments, import ordering, spacing, and formatting — without touching logic.",
+      "source": "./plugins/ezai-code-formatter",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-docs-writer",
+      "description": "Produce documentation content for software projects: MkDocs pages, API references, changelogs, and technical writing in a consistent style.",
+      "source": "./plugins/ezai-docs-writer",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-persona-senior-dev",
+      "description": "Elite Senior Developer persona for enterprise-grade Python and JavaScript/TypeScript projects. Apply for significant development tasks requiring senior-level judgment.",
+      "source": "./plugins/ezai-persona-senior-dev",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-project-architect",
+      "description": "Architecture and design standards for Python and JS/TS projects: module structure, public API surface, and design patterns (Repository, Service, Factory).",
+      "source": "./plugins/ezai-project-architect",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-project-config",
+      "description": "Toolchain setup, project configuration, and infrastructure standards for Python and JS/TS projects: pyproject.toml, package.json, linters, CI/CD.",
+      "source": "./plugins/ezai-project-config",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-project-performance",
+      "description": "Concurrency, async patterns, and performance optimization for Python and JS/TS projects: async/await, threading vs multiprocessing, profiling, and caching strategies.",
+      "source": "./plugins/ezai-project-performance",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    },
+    {
+      "name": "ezai-project-quality",
+      "description": "Testing, security, and input validation standards for Python and JS/TS projects: test architecture with pytest/Vitest, security patterns, and code quality enforcement.",
+      "source": "./plugins/ezai-project-quality",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "ezai",
+        "email": "floriansalort@gmail.com"
+      }
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,70 @@
+# ezai-marketplace
+
+Marketplace curated de skills IA pour Claude Code.
+
+## Installation
+
+### Via npm (recommandé)
+
+```bash
+# Sans installation globale
+npx ezai-marketplace install skill-mon-plugin
+
+# CLI global
+npm install -g ezai-marketplace
+```
+
+### Via script (sans Node.js)
+
+```bash
+git clone https://github.com/Neuraaak/ezai-marketplace
+cd ezai-marketplace
+scripts\install.bat skill-mon-plugin
+```
+
+## Commandes
+
+| Commande | Description |
+|---|---|
+| `ezai list` | Lister tous les plugins disponibles |
+| `ezai search <terme>` | Rechercher un plugin par nom ou catégorie |
+| `ezai info <plugin>` | Afficher les détails d'un plugin |
+| `ezai install <plugin>` | Installer un plugin dans `.agents/` |
+
+### Options
+
+- `--dest <chemin>` : Répertoire de destination (défaut : répertoire courant)
+
+## Structure d'un plugin
+
+```
+plugins/skill-mon-plugin/
+├── .claude-plugin/
+│   └── plugin.json
+└── skills/
+    └── <categorie>/
+        └── SKILL.md
+```
+
+### plugin.json
+
+```json
+{
+  "name": "skill-mon-plugin",
+  "version": "1.0.0",
+  "description": "Description du skill",
+  "author": "ezai",
+  "category": "ma-categorie",
+  "skills": ["skills/ma-categorie/SKILL.md"]
+}
+```
+
+## Mettre à jour le catalogue
+
+Après avoir ajouté un plugin dans `plugins/` :
+
+```bash
+node scripts/build-index.js
+# ou
+scripts\build-index.bat
+```

package/bin/ezai.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+'use strict';
+
+const { Command } = require('commander');
+const catalogue = require('../src/catalogue');
+const { runList } = require('../src/commands/list');
+const { runSearch } = require('../src/commands/search');
+const { runInfo } = require('../src/commands/info');
+const { runInstall } = require('../src/commands/install');
+const { runUninstall } = require('../src/commands/uninstall');
+
+const program = new Command();
+
+program.name('ezai').description('CLI du marketplace de skills IA ezai').version('1.0.0');
+
+program
+  .command('list')
+  .description('Lister tous les plugins disponibles')
+  .action(() =>
+    runList(catalogue).catch((err) => {
+      console.error(err.message);
+      process.exit(1);
+    })
+  );
+
+program
+  .command('search <terme>')
+  .description('Rechercher un plugin par nom ou catégorie')
+  .action((terme) =>
+    runSearch(terme, catalogue).catch((err) => {
+      console.error(err.message);
+      process.exit(1);
+    })
+  );
+
+program
+  .command('info <plugin>')
+  .description("Afficher les détails d'un plugin")
+  .action((plugin) =>
+    runInfo(plugin, catalogue).catch((err) => {
+      console.error(err.message);
+      process.exit(1);
+    })
+  );
+
+program
+  .command('install [plugin]')
+  .description('Installer un plugin (ou tous si aucun nom fourni) dans .agents/')
+  .option('--dest <chemin>', 'Répertoire de destination (défaut : répertoire home)')
+  .option('--claude', 'Déployer les symlinks vers ~/.claude/skills/')
+  .option('--gemini', 'Déployer les symlinks vers ~/.gemini/skills/')
+  .option('--copilot', 'Déployer les symlinks vers ~/.copilot/skills/')
+  .action((plugin, options) =>
+    runInstall(plugin, options, catalogue).catch((err) => {
+      console.error(err.message);
+      process.exit(1);
+    })
+  );
+
+program
+  .command('uninstall [skill]')
+  .description('Désinstaller un skill (ou tous si aucun nom fourni)')
+  .option('--dest <chemin>', 'Répertoire de base (défaut : répertoire home)')
+  .option('--claude', 'Supprimer uniquement les symlinks ~/.claude/skills/')
+  .option('--gemini', 'Supprimer uniquement les symlinks ~/.gemini/skills/')
+  .option('--copilot', 'Supprimer uniquement les symlinks ~/.copilot/skills/')
+  .action((skill, options) =>
+    runUninstall(skill, options, catalogue).catch((err) => {
+      console.error(err.message);
+      process.exit(1);
+    })
+  );
+
+program.parse();

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "ezai-marketplace",
+  "version": "1.0.0",
+  "description": "CLI pour installer des skills IA depuis le marketplace ezai",
+  "files": [
+    "bin/",
+    "src/",
+    "plugins/",
+    ".claude-plugin/"
+  ],
+  "main": "src/catalogue.js",
+  "bin": {
+    "ezai": "./bin/ezai.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "build-index": "node scripts/build-index.js",
+    "prepare": "simple-git-hooks"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "node scripts/build-index.js && git add .claude-plugin/marketplace.json && npx lint-staged && npm test"
+  },
+  "lint-staged": {
+    "*.js": [
+      "prettier --write",
+      "eslint --fix"
+    ]
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "claude",
+    "marketplace"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.4.0",
+    "eslint-config-prettier": "^10.1.8",
+    "jest": "^29.0.0",
+    "lint-staged": "^17.0.5",
+    "prettier": "^3.8.3",
+    "simple-git-hooks": "^2.13.1"
+  }
+}

package/plugins/ezai-code-formatter/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "ezai-code-formatter",
+  "description": "Apply source file visual structure to match project conventions: section header comments, import ordering, spacing, and formatting — without touching logic.",
+  "version": "1.0.0",
+  "author": {
+    "name": "ezai",
+    "email": "floriansalort@gmail.com"
+  },
+  "category": "development"
+}

package/plugins/ezai-code-formatter/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: ezai-code-formatter
+description:
+  "Apply this skill when a source file's visual structure needs to match
+  project conventions — not its logic. This means: adding section header comments (IMPORTS,
+  CONSTANTS, CLASSES, FUNCTIONS), inserting `# /////` or `# ---` separator lines, sorting
+  imports into Standard → third-party → local groups, or reorganizing class members
+  (constructor first, then public, then private methods).
+
+  Invoke when the user says a file \"doesn't look like the rest\", is \"missing section
+  markers\", needs imports \"reorganized by convention\", or wants a file \"formatted
+  according to our standards\". Supports Python, JS/TS, and any language with a
+  style-layout file in `references/`. Works for requests in any language (French/English/etc.).
+
+  Skip for: logic/bug fixes, linting tools (ruff, eslint, prettier), renaming."
+---
+
+You are a Code Formatter specialized in structural and visual project standards (2026). You do not run external tools like ruff or eslint; your role is to ensure the **visual landmarks** and **organization** of the code match the Project's Constitution.
+
+## Workflow
+
+1. **Detect the language**
+   - Identify the target file's language from its extension (`.py`, `.ts`, `.js`, etc.).
+   - Read `references/index.md` to find the matching subdirectory and confirm it is supported.
+
+2. **Load style standards**
+   - Load `references/<language>/style-layout.instructions.md` for the detected language.
+   - Use `<thinking>` tags to identify the specific markers and rules that apply (e.g., `# ///...`, `# ---...`).
+
+3. **Apply structural edits**
+   - Add/adjust main section separators (IMPORTS, CONSTANTS, CLASSES, FUNCTIONS).
+   - Reorganize imports: Standard/built-in → third-party → local, sorted alphabetically within each group.
+   - Group class members: constructor first, then public methods, then private methods.
+   - Enforce subsection markers (dashes) for internal class structure.
+
+4. **Cleanup**
+   - Remove "what" comments; keep "why" comments only.
+   - Ensure docstrings follow the language's canonical style (Google for Python, JSDoc for JS/TS).
+
+## Constraints
+
+- **No logic:** Never modify business logic, variable names, or function signatures.
+- **No shell:** Do not invoke ruff, eslint, prettier, or any external formatter.
+- **English:** All section headers and comments must be in English.
+- **Tools:** Read, Write, Edit, Glob, Grep only.
+
+## Output format
+
+Start with a `<thinking>` block identifying:
+
+- The detected language and subdirectory used
+- Which style rules apply (separator style, import groups, docstring format)
+
+Then provide a concise summary of structural changes made:
+
+- Which sections were added or adjusted
+- How imports were reorganized
+- Which comments were removed or preserved
+
+## Success criteria
+
+- Section markers are symmetrical and visually authoritative.
+- Imports are correctly grouped and alphabetically sorted within each group.
+- Code organization matches the class structure defined in the language's style layout.
+- Docstrings follow the canonical style for the detected language.

package/plugins/ezai-code-formatter/evals/eval_set_code_formatter.json

@@ -0,0 +1,23 @@
+{
+  "skill_name": "code-formatter",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Formate ce module Python selon les standards du projet. Il manque les séparateurs de sections, les imports sont mal organisés, et il n'y a pas de __all__ :\n\nimport os\nfrom mylib import helper\nimport sys\nfrom pathlib import Path\n\nAPI_URL = 'https://api.example.com'\n\ndef fetch_data(url: str) -> dict:\n    return {}\n\nclass DataClient:\n    def __init__(self): pass",
+      "expected_output": "Module restructuré avec séparateurs de sections (# ── Imports ──, # ── Constants ──, etc.), imports organisés (stdlib → third-party → local), __all__ défini, spacing cohérent.",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "Applique les standards de formatage visuels à ce fichier TypeScript. Les imports sont mélangés, il manque les séparateurs de sections et la cohérence des types :\n\nimport { Router } from 'express'\nimport type { User } from './types'\nimport fs from 'fs'\nimport { db } from '../db'\n\nconst MAX_RETRIES = 3\n\nexport async function getUser(id: string): Promise<User> {\n  return db.users.findOne(id)\n}",
+      "expected_output": "Fichier restructuré : imports groupés (Node built-ins → external → internal → types), séparateurs de sections visuels, exports explicites en bas ou inline cohérents, espacement normalisé.",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "Ce module Python a été récemment modifié. Identifie et applique uniquement les corrections de formatage nécessaires (pas de refactoring logique) :\n\nfrom typing import Optional,List\n\ndef process_items(items:List[str],limit:Optional[int]=None)->List[str]:\n    \"\"\"Process items.\"\"\"\n    result=[]\n    for item in items:\n        if limit and len(result)>=limit:break\n        result.append(item.strip())\n    return result",
+      "expected_output": "Espaces autour des : et , dans les annotations de type, espaces autour de = dans les defaults, indentation du corps de boucle, docstring complète si manquante. Aucun changement logique.",
+      "files": []
+    }
+  ]
+}

package/plugins/ezai-code-formatter/references/index.md

@@ -0,0 +1,36 @@
+# Code Formatter References Index
+
+Route to the correct language subdirectory based on the file extension.
+
+## Supported languages
+
+| Language           | Extensions              | Subdirectory      | File |
+| :----------------- | :---------------------- | :---------------- | :--- |
+| Python             | `.py`                   | `python/`         | `style-layout.instructions.md` |
+| JavaScript / TypeScript | `.js` `.ts` `.jsx` `.tsx` `.mjs` | `javascript/` | `style-layout.instructions.md` |
+
+More languages can be added under their own subdirectory following the same pattern.
+
+---
+
+## Python (`python/`)
+
+Docstring style: Google. Separator: `# ///...` (main) + `# ---...` (sub).
+
+- `python/style-layout.instructions.md` — section markers, import grouping, class structure, docstring format
+
+---
+
+## JavaScript / TypeScript (`javascript/`)
+
+Docstring style: JSDoc. Separator: `// ///...` (main) + `// ---...` (sub).
+
+- `javascript/style-layout.instructions.md` — section markers, import grouping (node:, 3rd-party, local), JSDoc format
+
+---
+
+## Adding a new language
+
+1. Create a `<language>/` subdirectory here.
+2. Add a `style-layout.instructions.md` covering: section separators, import grouping, docstring/comment style.
+3. Register the language in the table above.

package/plugins/ezai-code-formatter/references/javascript/style-layout.instructions.md

@@ -0,0 +1,69 @@
+# JS/TS Style & Layout Standards (UIA)
+
+Visual structure, import organization, and documentation standards for JS/TS source files.
+
+<rules>
+- **SECTIONING:** Use `// ///////////////////////////////////////////////////////////////` for main sections.
+- **DOCSTRINGS:** Use JSDoc (Google-style) for all public functions, classes, and types.
+- **IMPORTS:** Group by: 1. standard (node:), 2. 3rd-party, 3. local. Sort alphabetically.
+- **TYPES:** Use `import type` for TypeScript types to aid tree-shaking.
+- **COMMENTS:** Explain "why", not "what". Always use English.
+</rules>
+
+## Main Section Separators
+
+Use the forward slash separator for major code boundaries.
+
+```javascript
+// ///////////////////////////////////////////////////////////////
+// IMPORTS
+// ///////////////////////////////////////////////////////////////
+```
+
+## Subsection Markers
+
+Use dashes for internal organization within classes, functions, or modules.
+
+```javascript
+// ------------------------------------------------
+// PRIVATE METHODS
+// ------------------------------------------------
+```
+
+## Import Organization Pattern
+
+```javascript
+// ///////////////////////////////////////////////////////////////
+// IMPORTS
+// ///////////////////////////////////////////////////////////////
+// Standard library (node:)
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+
+// Third-party
+import express from "express";
+import { z } from "zod";
+
+// Local
+import { CustomError } from "./exceptions.js";
+```
+
+<examples>
+/**
+ * Calculates metrics for a dataset.
+ *
+ * @param {Array<number>} data - A list of numeric measurements.
+ * @returns {Record<string, number>} A mapping of metric names to values.
+ */
+function calculateMetrics(data: Array<number>): Record<string, number> {
+  // Implementation
+}
+</examples>
+
+<success_criteria>
+
+- Section markers used for navigation.
+- Imports correctly grouped and sorted.
+- JSDoc present for all public symbols.
+
+</success_criteria>

package/plugins/ezai-code-formatter/references/python/style-layout.instructions.md

@@ -0,0 +1,70 @@
+# Python Style & Layout Standards (UIA)
+
+Visual structure, import organization, and documentation standards for Python source files.
+
+<rules>
+- **SECTIONING:** Use `# ///////////////////////////////////////////////////////////////` for main sections.
+- **DOCSTRINGS:** Use Google-style docstrings exclusively.
+- **IMPORTS:** Group by: 1. stdlib, 2. 3rd-party, 3. local. Sort alphabetically.
+- **LANGUAGE:** Always use English for comments and docstrings.
+- **COMMENTS:** Explain "why", not "what". Avoid noise.
+</rules>
+
+## Main Section Separators
+
+Use the forward slash separator to create clear visual boundaries.
+
+```python
+# ///////////////////////////////////////////////////////////////
+# IMPORTS
+# ///////////////////////////////////////////////////////////////
+```
+
+## Subsection Markers
+
+Use dashes for internal organization within classes or functions.
+
+```python
+# ------------------------------------------------
+# PRIVATE METHODS
+# ------------------------------------------------
+```
+
+## Import Organization Pattern
+
+```python
+# ///////////////////////////////////////////////////////////////
+# IMPORTS
+# ///////////////////////////////////////////////////////////////
+# Standard library
+import os
+from pathlib import Path
+
+# Third-party
+from rich.console import Console
+
+# Local
+from .exceptions import CustomError
+```
+
+<examples>
+# Google-style docstring example
+def calculate_metrics(data: list[float]) -> dict[str, float]:
+    """Calculates statistical metrics for a dataset.
+
+    Args:
+        data: A list of numeric measurements.
+
+    Returns:
+        dict: A mapping of metric names to values.
+    """
+
+</examples>
+
+<success_criteria>
+
+- Section markers used for navigation.
+- Imports correctly grouped and sorted.
+- Google docstrings present for all public symbols.
+
+</success_criteria>

package/plugins/ezai-docs-writer/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "ezai-docs-writer",
+  "description": "Produce documentation content for software projects: MkDocs pages, API references, changelogs, and technical writing in a consistent style.",
+  "version": "1.0.0",
+  "author": {
+    "name": "ezai",
+    "email": "floriansalort@gmail.com"
+  },
+  "category": "development"
+}