@phuc1403/musketeer 0.7.0 → 0.9.0

package/template/.claude/skills/skill-creator/references/plugin-marketplace-hosting.md

@@ -1,104 +1,104 @@
-# Plugin Marketplace Hosting & Distribution
-
-## GitHub (Recommended)
-
-1. Create repository for marketplace
-2. Add `.claude-plugin/marketplace.json` with plugin definitions
-3. Share: users add via `/plugin marketplace add owner/repo`
-
-Benefits: version control, issue tracking, team collaboration.
-
-## Other Git Services (GitLab, Bitbucket, Self-Hosted)
-
-```shell
-/plugin marketplace add https://gitlab.com/company/plugins.git
-```
-
-## Private Repositories
-
-### Manual Install/Update
-Uses existing git credential helpers. If `git clone` works in terminal, it works in Claude Code.
-Common helpers: `gh auth login` (GitHub), macOS Keychain, `git-credential-store`.
-
-### Background Auto-Updates
-Runs at startup without credential helpers. Set auth tokens in environment:
-
-| Provider | Env Variables | Notes |
-|----------|--------------|-------|
-| GitHub | `GITHUB_TOKEN` or `GH_TOKEN` | PAT or GitHub App token |
-| GitLab | `GITLAB_TOKEN` or `GL_TOKEN` | PAT or project token |
-| Bitbucket | `BITBUCKET_TOKEN` | App password or repo token |
-
-```bash
-export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
-```
-
-CI/CD: configure as secret env variable. GitHub Actions auto-provides `GITHUB_TOKEN`.
-
-## Team Configuration
-
-### Auto-Prompt Marketplace Install
-
-Add to `.claude/settings.json` in your repo:
-
-```json
-{
-  "extraKnownMarketplaces": {
-    "company-tools": {
-      "source": { "source": "github", "repo": "your-org/claude-plugins" }
-    }
-  }
-}
-```
-
-### Default-Enabled Plugins
-
-```json
-{
-  "enabledPlugins": {
-    "code-formatter@company-tools": true,
-    "deployment-tools@company-tools": true
-  }
-}
-```
-
-## Managed Marketplace Restrictions
-
-Admins restrict allowed marketplaces via `strictKnownMarketplaces` in managed settings:
-
-| Value | Behavior |
-|-------|----------|
-| Undefined | No restrictions, users add any marketplace |
-| Empty `[]` | Complete lockdown, no new marketplaces |
-| List of sources | Users can only add matching marketplaces |
-
-### Allow Specific Only
-
-```json
-{
-  "strictKnownMarketplaces": [
-    { "source": "github", "repo": "acme-corp/approved-plugins" },
-    { "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" },
-    { "source": "url", "url": "https://plugins.example.com/marketplace.json" }
-  ]
-}
-```
-
-### Allow All from Internal Server (Regex)
-
-```json
-{
-  "strictKnownMarketplaces": [
-    { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
-  ]
-}
-```
-
-**Matching rules:** Exact match for most types. GitHub: `repo` required, `ref`/`path` must match if specified. URL: full URL exact match. `hostPattern`: regex against host. Validated before any network/filesystem ops. Cannot be overridden by user/project settings.
-
-## Local Testing
-
-```shell
-/plugin marketplace add ./my-local-marketplace
-/plugin install test-plugin@my-local-marketplace
-```
+# Plugin Marketplace Hosting & Distribution
+
+## GitHub (Recommended)
+
+1. Create repository for marketplace
+2. Add `.claude-plugin/marketplace.json` with plugin definitions
+3. Share: users add via `/plugin marketplace add owner/repo`
+
+Benefits: version control, issue tracking, team collaboration.
+
+## Other Git Services (GitLab, Bitbucket, Self-Hosted)
+
+```shell
+/plugin marketplace add https://gitlab.com/company/plugins.git
+```
+
+## Private Repositories
+
+### Manual Install/Update
+Uses existing git credential helpers. If `git clone` works in terminal, it works in Claude Code.
+Common helpers: `gh auth login` (GitHub), macOS Keychain, `git-credential-store`.
+
+### Background Auto-Updates
+Runs at startup without credential helpers. Set auth tokens in environment:
+
+| Provider | Env Variables | Notes |
+|----------|--------------|-------|
+| GitHub | `GITHUB_TOKEN` or `GH_TOKEN` | PAT or GitHub App token |
+| GitLab | `GITLAB_TOKEN` or `GL_TOKEN` | PAT or project token |
+| Bitbucket | `BITBUCKET_TOKEN` | App password or repo token |
+
+```bash
+export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
+```
+
+CI/CD: configure as secret env variable. GitHub Actions auto-provides `GITHUB_TOKEN`.
+
+## Team Configuration
+
+### Auto-Prompt Marketplace Install
+
+Add to `.claude/settings.json` in your repo:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "company-tools": {
+      "source": { "source": "github", "repo": "your-org/claude-plugins" }
+    }
+  }
+}
+```
+
+### Default-Enabled Plugins
+
+```json
+{
+  "enabledPlugins": {
+    "code-formatter@company-tools": true,
+    "deployment-tools@company-tools": true
+  }
+}
+```
+
+## Managed Marketplace Restrictions
+
+Admins restrict allowed marketplaces via `strictKnownMarketplaces` in managed settings:
+
+| Value | Behavior |
+|-------|----------|
+| Undefined | No restrictions, users add any marketplace |
+| Empty `[]` | Complete lockdown, no new marketplaces |
+| List of sources | Users can only add matching marketplaces |
+
+### Allow Specific Only
+
+```json
+{
+  "strictKnownMarketplaces": [
+    { "source": "github", "repo": "acme-corp/approved-plugins" },
+    { "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" },
+    { "source": "url", "url": "https://plugins.example.com/marketplace.json" }
+  ]
+}
+```
+
+### Allow All from Internal Server (Regex)
+
+```json
+{
+  "strictKnownMarketplaces": [
+    { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
+  ]
+}
+```
+
+**Matching rules:** Exact match for most types. GitHub: `repo` required, `ref`/`path` must match if specified. URL: full URL exact match. `hostPattern`: regex against host. Validated before any network/filesystem ops. Cannot be overridden by user/project settings.
+
+## Local Testing
+
+```shell
+/plugin marketplace add ./my-local-marketplace
+/plugin install test-plugin@my-local-marketplace
+```

package/template/.claude/skills/skill-creator/references/plugin-marketplace-overview.md

@@ -1,89 +1,89 @@
-# Plugin Marketplaces Overview
-
-Plugin marketplace = catalog distributing Claude Code extensions across teams/communities.
-Provides centralized discovery, version tracking, automatic updates, multiple source types.
-
-## Creation & Distribution Flow
-
-1. **Create plugins** — commands, agents, hooks, MCP servers, LSP servers (see [Plugins docs](https://code.claude.com/docs/en/plugins.md))
-2. **Create marketplace file** — `.claude-plugin/marketplace.json` listing plugins + sources
-3. **Host marketplace** — push to GitHub/GitLab/git host
-4. **Share** — users add via `/plugin marketplace add`, install via `/plugin install`
-
-Updates: push changes to repo → users refresh via `/plugin marketplace update`.
-
-## Directory Structure
-
-```
-my-marketplace/
-├── .claude-plugin/
-│   └── marketplace.json        # Marketplace catalog (required)
-└── plugins/
-    └── review-plugin/
-        ├── .claude-plugin/
-        │   └── plugin.json     # Plugin manifest
-        └── skills/
-            └── review/
-                └── SKILL.md    # Skill definition
-```
-
-## Walkthrough: Local Marketplace
-
-```bash
-# 1. Create structure
-mkdir -p my-marketplace/.claude-plugin
-mkdir -p my-marketplace/plugins/review-plugin/.claude-plugin
-mkdir -p my-marketplace/plugins/review-plugin/skills/review
-
-# 2. Create skill (SKILL.md), plugin manifest (plugin.json), marketplace catalog (marketplace.json)
-
-# 3. Add and install
-/plugin marketplace add ./my-marketplace
-/plugin install review-plugin@my-plugins
-
-# 4. Test
-/review
-```
-
-## Plugin Installation Behavior
-
-Plugins copied to cache location on install. Cannot reference files outside plugin directory with `../`.
-Workarounds: symlinks (followed during copying) or restructure so shared files are inside plugin source path.
-
-## User Commands
-
-| Command | Purpose |
-|---------|---------|
-| `/plugin marketplace add <source>` | Add marketplace |
-| `/plugin marketplace update` | Refresh marketplace |
-| `/plugin install <name>@<marketplace>` | Install plugin |
-| `/plugin validate .` | Validate marketplace JSON |
-| `claude plugin validate .` | CLI validation |
-
-## Validation & Testing
-
-```bash
-# Validate marketplace JSON
-claude plugin validate .
-# or within Claude Code:
-/plugin validate .
-
-# Test locally before distribution
-/plugin marketplace add ./my-local-marketplace
-/plugin install test-plugin@my-local-marketplace
-```
-
-## Related References
-
-- **Schema:** `references/plugin-marketplace-schema.md`
-- **Sources:** `references/plugin-marketplace-sources.md`
-- **Hosting:** `references/plugin-marketplace-hosting.md`
-- **Troubleshooting:** `references/plugin-marketplace-troubleshooting.md`
-
-## Official Documentation
-
-- [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces.md)
-- [Discover Plugins](https://code.claude.com/docs/en/discover-plugins.md)
-- [Create Plugins](https://code.claude.com/docs/en/plugins.md)
-- [Plugins Reference](https://code.claude.com/docs/en/plugins-reference.md)
-- [Plugin Settings](https://code.claude.com/docs/en/settings.md#plugin-settings)
+# Plugin Marketplaces Overview
+
+Plugin marketplace = catalog distributing Claude Code extensions across teams/communities.
+Provides centralized discovery, version tracking, automatic updates, multiple source types.
+
+## Creation & Distribution Flow
+
+1. **Create plugins** — commands, agents, hooks, MCP servers, LSP servers (see [Plugins docs](https://code.claude.com/docs/en/plugins.md))
+2. **Create marketplace file** — `.claude-plugin/marketplace.json` listing plugins + sources
+3. **Host marketplace** — push to GitHub/GitLab/git host
+4. **Share** — users add via `/plugin marketplace add`, install via `/plugin install`
+
+Updates: push changes to repo → users refresh via `/plugin marketplace update`.
+
+## Directory Structure
+
+```
+my-marketplace/
+├── .claude-plugin/
+│   └── marketplace.json        # Marketplace catalog (required)
+└── plugins/
+    └── review-plugin/
+        ├── .claude-plugin/
+        │   └── plugin.json     # Plugin manifest
+        └── skills/
+            └── review/
+                └── SKILL.md    # Skill definition
+```
+
+## Walkthrough: Local Marketplace
+
+```bash
+# 1. Create structure
+mkdir -p my-marketplace/.claude-plugin
+mkdir -p my-marketplace/plugins/review-plugin/.claude-plugin
+mkdir -p my-marketplace/plugins/review-plugin/skills/review
+
+# 2. Create skill (SKILL.md), plugin manifest (plugin.json), marketplace catalog (marketplace.json)
+
+# 3. Add and install
+/plugin marketplace add ./my-marketplace
+/plugin install review-plugin@my-plugins
+
+# 4. Test
+/review
+```
+
+## Plugin Installation Behavior
+
+Plugins copied to cache location on install. Cannot reference files outside plugin directory with `../`.
+Workarounds: symlinks (followed during copying) or restructure so shared files are inside plugin source path.
+
+## User Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/plugin marketplace add <source>` | Add marketplace |
+| `/plugin marketplace update` | Refresh marketplace |
+| `/plugin install <name>@<marketplace>` | Install plugin |
+| `/plugin validate .` | Validate marketplace JSON |
+| `claude plugin validate .` | CLI validation |
+
+## Validation & Testing
+
+```bash
+# Validate marketplace JSON
+claude plugin validate .
+# or within Claude Code:
+/plugin validate .
+
+# Test locally before distribution
+/plugin marketplace add ./my-local-marketplace
+/plugin install test-plugin@my-local-marketplace
+```
+
+## Related References
+
+- **Schema:** `references/plugin-marketplace-schema.md`
+- **Sources:** `references/plugin-marketplace-sources.md`
+- **Hosting:** `references/plugin-marketplace-hosting.md`
+- **Troubleshooting:** `references/plugin-marketplace-troubleshooting.md`
+
+## Official Documentation
+
+- [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces.md)
+- [Discover Plugins](https://code.claude.com/docs/en/discover-plugins.md)
+- [Create Plugins](https://code.claude.com/docs/en/plugins.md)
+- [Plugins Reference](https://code.claude.com/docs/en/plugins-reference.md)
+- [Plugin Settings](https://code.claude.com/docs/en/settings.md#plugin-settings)

package/template/.claude/skills/skill-creator/references/plugin-marketplace-schema.md

@@ -1,93 +1,93 @@
-# Plugin Marketplace Schema
-
-Full JSON schema for `.claude-plugin/marketplace.json`.
-
-## Required Top-Level Fields
-
-| Field | Type | Description | Example |
-|-------|------|-------------|---------|
-| `name` | string | Marketplace ID (kebab-case, no spaces). Users see: `/plugin install tool@name` | `"acme-tools"` |
-| `owner` | object | Maintainer info (`name` required, `email` optional) | |
-| `plugins` | array | List of plugin entries | |
-
-### Reserved Names (Cannot Use)
-
-`claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `life-sciences`. Names impersonating official marketplaces also blocked.
-
-## Optional Metadata
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `metadata.description` | string | Brief marketplace description |
-| `metadata.version` | string | Marketplace version |
-| `metadata.pluginRoot` | string | Base dir prepended to relative source paths (e.g., `"./plugins"`) |
-
-## Plugin Entry — Required Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | string | Plugin ID (kebab-case). Users see: `/plugin install name@marketplace` |
-| `source` | string\|object | Where to fetch plugin (see `plugin-marketplace-sources.md`) |
-
-## Plugin Entry — Optional Metadata
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `description` | string | Brief plugin description |
-| `version` | string | Plugin version |
-| `author` | object | Author info (`name` required, `email` optional) |
-| `homepage` | string | Plugin docs URL |
-| `repository` | string | Source code URL |
-| `license` | string | SPDX license ID (MIT, Apache-2.0) |
-| `keywords` | array | Discovery/categorization tags |
-| `category` | string | Plugin category |
-| `tags` | array | Searchability tags |
-| `strict` | boolean | Default `true`: merges with plugin.json. `false`: marketplace entry defines plugin entirely |
-
-## Plugin Entry — Component Configuration
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `commands` | string\|array | Custom paths to command files/dirs |
-| `agents` | string\|array | Custom paths to agent files |
-| `hooks` | string\|object | Hooks config or path to hooks file |
-| `mcpServers` | string\|object | MCP server configs or path |
-| `lspServers` | string\|object | LSP server configs or path |
-
-## Minimal Example
-
-```json
-{
-  "name": "my-plugins",
-  "owner": { "name": "Your Name" },
-  "plugins": [{
-    "name": "review-plugin",
-    "source": "./plugins/review-plugin",
-    "description": "Adds a review skill for quick code reviews"
-  }]
-}
-```
-
-## Full Example
-
-```json
-{
-  "name": "company-tools",
-  "owner": { "name": "DevTools Team", "email": "devtools@example.com" },
-  "metadata": { "description": "Internal dev tools", "version": "1.0.0", "pluginRoot": "./plugins" },
-  "plugins": [
-    {
-      "name": "code-formatter",
-      "source": "./plugins/formatter",
-      "description": "Automatic code formatting on save",
-      "version": "2.1.0",
-      "author": { "name": "DevTools Team" }
-    },
-    {
-      "name": "deployment-tools",
-      "source": { "source": "github", "repo": "company/deploy-plugin" },
-      "description": "Deployment automation tools"
-    }
-  ]
-}
-```
+# Plugin Marketplace Schema
+
+Full JSON schema for `.claude-plugin/marketplace.json`.
+
+## Required Top-Level Fields
+
+| Field | Type | Description | Example |
+|-------|------|-------------|---------|
+| `name` | string | Marketplace ID (kebab-case, no spaces). Users see: `/plugin install tool@name` | `"acme-tools"` |
+| `owner` | object | Maintainer info (`name` required, `email` optional) | |
+| `plugins` | array | List of plugin entries | |
+
+### Reserved Names (Cannot Use)
+
+`claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `life-sciences`. Names impersonating official marketplaces also blocked.
+
+## Optional Metadata
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `metadata.description` | string | Brief marketplace description |
+| `metadata.version` | string | Marketplace version |
+| `metadata.pluginRoot` | string | Base dir prepended to relative source paths (e.g., `"./plugins"`) |
+
+## Plugin Entry — Required Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | string | Plugin ID (kebab-case). Users see: `/plugin install name@marketplace` |
+| `source` | string\|object | Where to fetch plugin (see `plugin-marketplace-sources.md`) |
+
+## Plugin Entry — Optional Metadata
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `description` | string | Brief plugin description |
+| `version` | string | Plugin version |
+| `author` | object | Author info (`name` required, `email` optional) |
+| `homepage` | string | Plugin docs URL |
+| `repository` | string | Source code URL |
+| `license` | string | SPDX license ID (MIT, Apache-2.0) |
+| `keywords` | array | Discovery/categorization tags |
+| `category` | string | Plugin category |
+| `tags` | array | Searchability tags |
+| `strict` | boolean | Default `true`: merges with plugin.json. `false`: marketplace entry defines plugin entirely |
+
+## Plugin Entry — Component Configuration
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `commands` | string\|array | Custom paths to command files/dirs |
+| `agents` | string\|array | Custom paths to agent files |
+| `hooks` | string\|object | Hooks config or path to hooks file |
+| `mcpServers` | string\|object | MCP server configs or path |
+| `lspServers` | string\|object | LSP server configs or path |
+
+## Minimal Example
+
+```json
+{
+  "name": "my-plugins",
+  "owner": { "name": "Your Name" },
+  "plugins": [{
+    "name": "review-plugin",
+    "source": "./plugins/review-plugin",
+    "description": "Adds a review skill for quick code reviews"
+  }]
+}
+```
+
+## Full Example
+
+```json
+{
+  "name": "company-tools",
+  "owner": { "name": "DevTools Team", "email": "devtools@example.com" },
+  "metadata": { "description": "Internal dev tools", "version": "1.0.0", "pluginRoot": "./plugins" },
+  "plugins": [
+    {
+      "name": "code-formatter",
+      "source": "./plugins/formatter",
+      "description": "Automatic code formatting on save",
+      "version": "2.1.0",
+      "author": { "name": "DevTools Team" }
+    },
+    {
+      "name": "deployment-tools",
+      "source": { "source": "github", "repo": "company/deploy-plugin" },
+      "description": "Deployment automation tools"
+    }
+  ]
+}
+```