@phuc1403/musketeer 0.8.0 → 0.9.0

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

@@ -1,103 +1,103 @@
-# Plugin Marketplace Sources
-
-Plugin source types for `marketplace.json` plugin entries.
-
-## Relative Paths (Same Repo)
-
-```json
-{ "name": "my-plugin", "source": "./plugins/my-plugin" }
-```
-
-**Note:** Only works when marketplace added via Git (GitHub/GitLab/git URL). URL-based marketplaces only download `marketplace.json`, not plugin files. Use GitHub/git sources for URL-based distribution.
-
-## GitHub Repositories
-
-```json
-{
-  "name": "github-plugin",
-  "source": { "source": "github", "repo": "owner/plugin-repo" }
-}
-```
-
-Pin to specific version:
-```json
-{
-  "name": "github-plugin",
-  "source": {
-    "source": "github",
-    "repo": "owner/plugin-repo",
-    "ref": "v2.0.0",
-    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
-  }
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `repo` | string | Required. `owner/repo` format |
-| `ref` | string | Optional. Branch or tag (defaults to repo default) |
-| `sha` | string | Optional. Full 40-char commit SHA for exact pinning |
-
-## Git Repositories (GitLab, Bitbucket, etc.)
-
-```json
-{
-  "name": "git-plugin",
-  "source": { "source": "url", "url": "https://gitlab.com/team/plugin.git" }
-}
-```
-
-Pin to specific version:
-```json
-{
-  "name": "git-plugin",
-  "source": {
-    "source": "url",
-    "url": "https://gitlab.com/team/plugin.git",
-    "ref": "main",
-    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
-  }
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` | string | Required. Full git URL (must end `.git`) |
-| `ref` | string | Optional. Branch or tag |
-| `sha` | string | Optional. Full 40-char commit SHA |
-
-## Advanced Example (All Features)
-
-```json
-{
-  "name": "enterprise-tools",
-  "source": { "source": "github", "repo": "company/enterprise-plugin" },
-  "description": "Enterprise workflow automation tools",
-  "version": "2.1.0",
-  "author": { "name": "Enterprise Team", "email": "enterprise@example.com" },
-  "homepage": "https://docs.example.com/plugins/enterprise-tools",
-  "license": "MIT",
-  "keywords": ["enterprise", "workflow", "automation"],
-  "category": "productivity",
-  "commands": ["./commands/core/", "./commands/enterprise/"],
-  "agents": ["./agents/security-reviewer.md", "./agents/compliance-checker.md"],
-  "hooks": {
-    "PostToolUse": [{
-      "matcher": "Write|Edit",
-      "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh" }]
-    }]
-  },
-  "mcpServers": {
-    "enterprise-db": {
-      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
-      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
-    }
-  },
-  "strict": false
-}
-```
-
-**Key notes:**
-- `${CLAUDE_PLUGIN_ROOT}` — references files within plugin's installation cache directory
-- `strict: false` — marketplace entry defines plugin entirely, no `plugin.json` needed
-- `commands`/`agents` — multiple directories or individual files, paths relative to plugin root
+# Plugin Marketplace Sources
+
+Plugin source types for `marketplace.json` plugin entries.
+
+## Relative Paths (Same Repo)
+
+```json
+{ "name": "my-plugin", "source": "./plugins/my-plugin" }
+```
+
+**Note:** Only works when marketplace added via Git (GitHub/GitLab/git URL). URL-based marketplaces only download `marketplace.json`, not plugin files. Use GitHub/git sources for URL-based distribution.
+
+## GitHub Repositories
+
+```json
+{
+  "name": "github-plugin",
+  "source": { "source": "github", "repo": "owner/plugin-repo" }
+}
+```
+
+Pin to specific version:
+```json
+{
+  "name": "github-plugin",
+  "source": {
+    "source": "github",
+    "repo": "owner/plugin-repo",
+    "ref": "v2.0.0",
+    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
+  }
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `repo` | string | Required. `owner/repo` format |
+| `ref` | string | Optional. Branch or tag (defaults to repo default) |
+| `sha` | string | Optional. Full 40-char commit SHA for exact pinning |
+
+## Git Repositories (GitLab, Bitbucket, etc.)
+
+```json
+{
+  "name": "git-plugin",
+  "source": { "source": "url", "url": "https://gitlab.com/team/plugin.git" }
+}
+```
+
+Pin to specific version:
+```json
+{
+  "name": "git-plugin",
+  "source": {
+    "source": "url",
+    "url": "https://gitlab.com/team/plugin.git",
+    "ref": "main",
+    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
+  }
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` | string | Required. Full git URL (must end `.git`) |
+| `ref` | string | Optional. Branch or tag |
+| `sha` | string | Optional. Full 40-char commit SHA |
+
+## Advanced Example (All Features)
+
+```json
+{
+  "name": "enterprise-tools",
+  "source": { "source": "github", "repo": "company/enterprise-plugin" },
+  "description": "Enterprise workflow automation tools",
+  "version": "2.1.0",
+  "author": { "name": "Enterprise Team", "email": "enterprise@example.com" },
+  "homepage": "https://docs.example.com/plugins/enterprise-tools",
+  "license": "MIT",
+  "keywords": ["enterprise", "workflow", "automation"],
+  "category": "productivity",
+  "commands": ["./commands/core/", "./commands/enterprise/"],
+  "agents": ["./agents/security-reviewer.md", "./agents/compliance-checker.md"],
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Write|Edit",
+      "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh" }]
+    }]
+  },
+  "mcpServers": {
+    "enterprise-db": {
+      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
+      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
+    }
+  },
+  "strict": false
+}
+```
+
+**Key notes:**
+- `${CLAUDE_PLUGIN_ROOT}` — references files within plugin's installation cache directory
+- `strict: false` — marketplace entry defines plugin entirely, no `plugin.json` needed
+- `commands`/`agents` — multiple directories or individual files, paths relative to plugin root

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

@@ -1,76 +1,76 @@
-# Plugin Marketplace Troubleshooting
-
-## Marketplace Not Loading
-
-**Symptoms:** Can't add marketplace or see plugins.
-
-**Checklist:**
-- Marketplace URL accessible?
-- `.claude-plugin/marketplace.json` exists at specified path?
-- JSON syntax valid? Run `claude plugin validate .` or `/plugin validate .`
-- Private repo — do you have access permissions?
-
-## Validation Errors
-
-Run `claude plugin validate .` from marketplace directory. Common errors:
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `File not found: .claude-plugin/marketplace.json` | Missing manifest | Create with required fields |
-| `Invalid JSON syntax: Unexpected token...` | JSON syntax error | Fix commas, quotes, brackets |
-| `Duplicate plugin name "x"` | Two plugins share name | Give unique `name` values |
-| `plugins[0].source: Path traversal not allowed` | Source contains `..` | Use paths relative to root, no `..` |
-
-**Warnings (non-blocking):**
-- `Marketplace has no plugins defined` — add plugins to array
-- `No marketplace description provided` — add `metadata.description`
-- `Plugin "x" uses npm source` — npm not fully implemented, use github/local
-
-## Plugin Installation Failures
-
-**Symptoms:** Marketplace appears but install fails.
-
-**Checklist:**
-- Plugin source URLs accessible?
-- Plugin directories contain required files?
-- GitHub sources — repos public or you have access?
-- Test manually by cloning/downloading source
-
-## Private Repository Auth Fails
-
-### Manual Install/Update
-- Authenticated with git provider? `gh auth status` for GitHub
-- Credential helper configured? `git config --global credential.helper`
-- Can you clone repo manually?
-
-### Background Auto-Updates
-- Token set in environment? `echo $GITHUB_TOKEN`
-- Token has required permissions?
-  - GitHub: `repo` scope for private repos
-  - GitLab: `read_repository` scope minimum
-- Token not expired?
-
-## Relative Paths Fail in URL-Based Marketplaces
-
-**Symptoms:** Added marketplace via URL, plugins with `"./plugins/my-plugin"` source fail.
-
-**Cause:** URL-based marketplaces only download `marketplace.json`, not plugin files. Relative paths reference files on remote server that weren't downloaded.
-
-**Fixes:**
-1. **Use external sources:**
-   ```json
-   { "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }
-   ```
-2. **Use Git-based marketplace:** Host in Git repo, add via git URL. Clones entire repo, relative paths work.
-
-## Files Not Found After Installation
-
-**Symptoms:** Plugin installs but file references fail, especially outside plugin directory.
-
-**Cause:** Plugins copied to cache directory, not used in-place. Paths like `../shared-utils` won't work.
-
-**Fixes:**
-- Use symlinks (followed during copying)
-- Restructure so shared directory is inside plugin source path
-- Use `${CLAUDE_PLUGIN_ROOT}` in hooks/MCP configs for cache-aware paths
-- See [Plugin caching docs](https://code.claude.com/docs/en/plugins-reference.md#plugin-caching-and-file-resolution)
+# Plugin Marketplace Troubleshooting
+
+## Marketplace Not Loading
+
+**Symptoms:** Can't add marketplace or see plugins.
+
+**Checklist:**
+- Marketplace URL accessible?
+- `.claude-plugin/marketplace.json` exists at specified path?
+- JSON syntax valid? Run `claude plugin validate .` or `/plugin validate .`
+- Private repo — do you have access permissions?
+
+## Validation Errors
+
+Run `claude plugin validate .` from marketplace directory. Common errors:
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| `File not found: .claude-plugin/marketplace.json` | Missing manifest | Create with required fields |
+| `Invalid JSON syntax: Unexpected token...` | JSON syntax error | Fix commas, quotes, brackets |
+| `Duplicate plugin name "x"` | Two plugins share name | Give unique `name` values |
+| `plugins[0].source: Path traversal not allowed` | Source contains `..` | Use paths relative to root, no `..` |
+
+**Warnings (non-blocking):**
+- `Marketplace has no plugins defined` — add plugins to array
+- `No marketplace description provided` — add `metadata.description`
+- `Plugin "x" uses npm source` — npm not fully implemented, use github/local
+
+## Plugin Installation Failures
+
+**Symptoms:** Marketplace appears but install fails.
+
+**Checklist:**
+- Plugin source URLs accessible?
+- Plugin directories contain required files?
+- GitHub sources — repos public or you have access?
+- Test manually by cloning/downloading source
+
+## Private Repository Auth Fails
+
+### Manual Install/Update
+- Authenticated with git provider? `gh auth status` for GitHub
+- Credential helper configured? `git config --global credential.helper`
+- Can you clone repo manually?
+
+### Background Auto-Updates
+- Token set in environment? `echo $GITHUB_TOKEN`
+- Token has required permissions?
+  - GitHub: `repo` scope for private repos
+  - GitLab: `read_repository` scope minimum
+- Token not expired?
+
+## Relative Paths Fail in URL-Based Marketplaces
+
+**Symptoms:** Added marketplace via URL, plugins with `"./plugins/my-plugin"` source fail.
+
+**Cause:** URL-based marketplaces only download `marketplace.json`, not plugin files. Relative paths reference files on remote server that weren't downloaded.
+
+**Fixes:**
+1. **Use external sources:**
+   ```json
+   { "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }
+   ```
+2. **Use Git-based marketplace:** Host in Git repo, add via git URL. Clones entire repo, relative paths work.
+
+## Files Not Found After Installation
+
+**Symptoms:** Plugin installs but file references fail, especially outside plugin directory.
+
+**Cause:** Plugins copied to cache directory, not used in-place. Paths like `../shared-utils` won't work.
+
+**Fixes:**
+- Use symlinks (followed during copying)
+- Restructure so shared directory is inside plugin source path
+- Use `${CLAUDE_PLUGIN_ROOT}` in hooks/MCP configs for cache-aware paths
+- See [Plugin caching docs](https://code.claude.com/docs/en/plugins-reference.md#plugin-caching-and-file-resolution)

package/template/.claude/skills/skill-creator/references/script-quality-criteria.md

@@ -1,106 +1,106 @@
-# Script Quality Criteria
-
-Scripts provide deterministic reliability and token efficiency.
-
-## When to Include Scripts
-
-- Same code rewritten repeatedly
-- Deterministic operations needed
-- Complex transformations
-- External tool integrations
-
-## Cross-Platform Requirements
-
-**Prefer:** Node.js or Python
-**Avoid:** Bash scripts (not well-supported on Windows)
-
-If bash required, provide Node.js/Python alternative.
-
-## Testing Requirements
-
-**Mandatory:** All scripts must have tests
-
-```bash
-# Run tests before packaging
-python -m pytest scripts/tests/
-# or
-npm test
-```
-
-Tests must pass. No skipping failed tests.
-
-## Environment Variables
-
-Respect hierarchy (first found wins):
-
-1. `process.env` (runtime)
-2. `$HOME/.claude/skills/<skill-name>/.env` (skill-specific)
-3. `$HOME/.claude/skills/.env` (shared skills)
-4. `$HOME/.claude/.env` (global)
-5. `./.claude/skills/${SKILL}/.env` (cwd)
-6. `./.claude/skills/.env` (cwd)
-7. `./.claude/.env` (cwd)
-
-**Implementation pattern (Python):**
-
-```python
-from dotenv import load_dotenv
-import os
-
-# Load in reverse order (last loaded wins if not set)
-load_dotenv('$HOME/.claude/.env')
-load_dotenv('$HOME/.claude/skills/.env')
-load_dotenv('$HOME/.claude/skills/my-skill/.env')
-load_dotenv('./.claude/skills/my-skill/.env')
-load_dotenv('./.claude/skills/.env')
-load_dotenv('./.claude/.env')
-# process.env already takes precedence
-```
-
-## Documentation Requirements
-
-### .env.example
-Show required variables without values:
-
-```
-API_KEY=
-DATABASE_URL=
-DEBUG=false
-```
-
-### requirements.txt (Python)
-Pin major versions:
-
-```
-requests>=2.28.0
-python-dotenv>=1.0.0
-```
-
-### package.json (Node.js)
-Include scripts:
-
-```json
-{
-  "scripts": {
-    "test": "jest"
-  }
-}
-```
-
-## Manual Testing
-
-Before packaging, test with real use cases:
-
-```bash
-# Example: PDF rotation script
-python scripts/rotate_pdf.py input.pdf 90 output.pdf
-```
-
-Verify output matches expectations.
-
-## Error Handling
-
-- Clear error messages
-- Graceful failures
-- No silent errors
-- Exit codes: 0 success, non-zero failure
+# Script Quality Criteria
+
+Scripts provide deterministic reliability and token efficiency.
+
+## When to Include Scripts
+
+- Same code rewritten repeatedly
+- Deterministic operations needed
+- Complex transformations
+- External tool integrations
+
+## Cross-Platform Requirements
+
+**Prefer:** Node.js or Python
+**Avoid:** Bash scripts (not well-supported on Windows)
+
+If bash required, provide Node.js/Python alternative.
+
+## Testing Requirements
+
+**Mandatory:** All scripts must have tests
+
+```bash
+# Run tests before packaging
+python -m pytest scripts/tests/
+# or
+npm test
+```
+
+Tests must pass. No skipping failed tests.
+
+## Environment Variables
+
+Respect hierarchy (first found wins):
+
+1. `process.env` (runtime)
+2. `$HOME/.claude/skills/<skill-name>/.env` (skill-specific)
+3. `$HOME/.claude/skills/.env` (shared skills)
+4. `$HOME/.claude/.env` (global)
+5. `./.claude/skills/${SKILL}/.env` (cwd)
+6. `./.claude/skills/.env` (cwd)
+7. `./.claude/.env` (cwd)
+
+**Implementation pattern (Python):**
+
+```python
+from dotenv import load_dotenv
+import os
+
+# Load in reverse order (last loaded wins if not set)
+load_dotenv('$HOME/.claude/.env')
+load_dotenv('$HOME/.claude/skills/.env')
+load_dotenv('$HOME/.claude/skills/my-skill/.env')
+load_dotenv('./.claude/skills/my-skill/.env')
+load_dotenv('./.claude/skills/.env')
+load_dotenv('./.claude/.env')
+# process.env already takes precedence
+```
+
+## Documentation Requirements
+
+### .env.example
+Show required variables without values:
+
+```
+API_KEY=
+DATABASE_URL=
+DEBUG=false
+```
+
+### requirements.txt (Python)
+Pin major versions:
+
+```
+requests>=2.28.0
+python-dotenv>=1.0.0
+```
+
+### package.json (Node.js)
+Include scripts:
+
+```json
+{
+  "scripts": {
+    "test": "jest"
+  }
+}
+```
+
+## Manual Testing
+
+Before packaging, test with real use cases:
+
+```bash
+# Example: PDF rotation script
+python scripts/rotate_pdf.py input.pdf 90 output.pdf
+```
+
+Verify output matches expectations.
+
+## Error Handling
+
+- Clear error messages
+- Graceful failures
+- No silent errors
+- Exit codes: 0 success, non-zero failure