Skip to content

feat: Claude Code plugin packaging and multi-app setup docs#34

Merged
hybridindie merged 2 commits intomainfrom
worktree-plugin-packaging
Mar 13, 2026
Merged

feat: Claude Code plugin packaging and multi-app setup docs#34
hybridindie merged 2 commits intomainfrom
worktree-plugin-packaging

Conversation

@hybridindie
Copy link
Owner

Summary

  • Add Claude Code plugin structure (.claude-plugin/plugin.json, .mcp.json) with plugin name comfy for /comfy:* slash commands
  • Create 6 slash command skills (/comfy:gen, /comfy:workflow, /comfy:status, /comfy:models, /comfy:history, /comfy:progress) and 2 contextual knowledge skills (workflow building guide, troubleshooting guide)
  • Add PostToolUse security hook that surfaces warnings when dangerous node patterns are detected after audit_dangerous_nodes, install_custom_node, update_custom_node, run_workflow, or generate_image
  • Add Setup section to README with copy-paste config snippets for 8 client environments (Claude Code, Claude Desktop, VS Code/Copilot, Cursor, Windsurf, Continue.dev, OpenCode, Open WebUI) with both uvx and Docker variants

Closes #16

Test plan

  • claude --plugin-dir . from repo root — verify slash commands appear as /comfy:gen, /comfy:status, etc.
  • /comfy:gen "a sunset" — verify orchestration flow calls list_modelsgenerate_imageget_image
  • /comfy:status — verify get_queue is called and output formatted
  • Trigger security warning (install node with dangerous patterns) — verify hook fires
  • Verify all JSON config snippets in README are syntactically valid
  • Verify all YAML config snippets in README are syntactically valid

🤖 Generated with Claude Code

Package the MCP server as a Claude Code plugin with slash commands,
contextual skills, and a security hook. Add configuration snippets
for 8 client environments (Claude Code, Claude Desktop, VS Code,
Cursor, Windsurf, Continue.dev, OpenCode, Open WebUI).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 13, 2026 14:59
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Packages this MCP server as a Claude Code plugin (slash commands + skills + hooks) and expands the README with multi-environment setup snippets so users can connect various AI clients to the ComfyUI MCP server.

Changes:

  • Added Claude Code “skills” markdown files for /comfy:* workflows (gen/status/models/history/progress/workflow) plus contextual workflow/troubleshooting knowledge.
  • Added a PostToolUse hook configuration and a shell hook intended to surface security warnings.
  • Reworked README setup guidance with copy/paste configs for multiple clients and added a root .mcp.json example.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
skills/workflows/SKILL.md Adds a workflow-building knowledge skill document.
skills/workflow/SKILL.md Adds /comfy:workflow slash-command skill instructions.
skills/troubleshooting/SKILL.md Adds troubleshooting knowledge skill document.
skills/status/SKILL.md Adds /comfy:status skill instructions.
skills/progress/SKILL.md Adds /comfy:progress skill instructions.
skills/models/SKILL.md Adds /comfy:models skill instructions.
skills/history/SKILL.md Adds /comfy:history skill instructions.
skills/gen/SKILL.md Adds /comfy:gen skill instructions.
hooks/security-warning.sh Implements a post-tool hook to emit a security warning message.
hooks/hooks.json Registers the post-tool hook for specific MCP tool invocations.
README.md Adds “Setup” section with client-specific configuration snippets and verification commands.
.mcp.json Adds a project-local MCP server config example.
.claude-plugin/plugin.json Adds Claude plugin metadata (name/description/version).

You can also share your feedback on Copilot code review. Take the survey.

Comment on lines +53 to +60
| Node | Purpose | Key Inputs |
|------|---------|------------|
| `CheckpointLoaderSimple` | Load a model checkpoint | `ckpt_name` |
| `CLIPTextEncode` | Encode text prompt | `text`, `clip` |
| `KSampler` | Run diffusion sampling | `model`, `positive`, `negative`, `latent_image`, `steps`, `cfg`, `seed` |
| `VAEDecode` | Decode latent to image | `samples`, `vae` |
| `VAEEncode` | Encode image to latent | `pixels`, `vae` |
| `SaveImage` | Save output image | `images`, `filename_prefix` |
# Reads tool output JSON from stdin. Exits 0 always (non-blocking).

input=$(cat)
if echo "$input" | grep -qi "DANGEROUS"; then
README.md Outdated
"-v", "~/.comfyui-mcp:/root/.comfyui-mcp:ro",
"ghcr.io/hybridindie/comfyui-mcp:latest"
]
"args": ["run", "-i", "--rm", "-e", "COMFYUI_URL=http://host.docker.internal:8188", "ghcr.io/hybridindie/comfyui_mcp"],
Comment on lines +98 to +100
```bash
claude plugin install github:hybridindie/comfyui_mcp
```
- Fix security-warning.sh to match specific warning patterns instead
  of grepping for "DANGEROUS" which false-positives on JSON keys
- Align all Docker image references to ghcr.io/hybridindie/comfyui_mcp:main
  (underscore, :main tag) matching the actual CI workflow output

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@hybridindie hybridindie merged commit 34bd989 into main Mar 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Claude Code plugin packaging (slash commands, hooks, skills)

2 participants