Run any Skill in Manus with one click

managing-mcp-index

Stars651

Forks141

UpdatedJune 24, 2026 at 17:22

Builds and maintains templates/index.mcp.json for Comfy Cloud MCP tools. Covers deterministic sync from index.json, AI-generated English descriptions, model registry profiles, template cache, recommend/freshness overrides, and API node scanning. Use when asked to: sync MCP index, index.mcp.json, mcp sync, enhance MCP descriptions, AI template descriptions for MCP, models_registry, template_cache, recommend override, freshness, MCP pipeline, run mcp, mcp:ai, update MCP metadata, regenerate MCP copy, Use Cases MCP descriptions. NOT for site SEO (site/generate-ai) or hub i18n (sync:i18n / managing-translations). Triggers on: mcp index, index.mcp, mcp sync, template cache, models registry, mcp ai, recommend, MCP description.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Comfy-Org

Comfy-Org/workflow_templates

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Computer Occupations, All OtherComputer and Mathematical Occupations·SOC 15-1299

SKILL.md

readonly

More from this repository

same repository

managing-templates

Comfy-Org/workflow_templates

Manages ComfyUI workflow templates end-to-end: add new templates and rename existing ones (files, index metadata, bundles, i18n, package sync). Use when asked to: add a template, create a new template, submit a workflow, rename a template, retitle a template slug, change a template name, rename workflow template, onboard a template, register a template, ship a template. Triggers on: add template, new template, new workflow, rename template, rename workflow, change template name, template rename.

2026-07-17651

importing-subgraphs

Comfy-Org/workflow_templates

Imports and registers subgraph blueprints into the ComfyUI workflow_templates repository. Handles placing blueprint JSON files, adding thumbnails, running the import/sync pipeline, and validating results. Use when asked to: import a subgraph, add a blueprint, register a blueprint, add a subgraph blueprint, import a subgraph blueprint, contribute a subgraph, add a new node component, publish a blueprint, upload a subgraph, create a blueprint, onboard a subgraph, add a reusable node. Triggers on: import subgraph, add blueprint, subgraph blueprint, new blueprint, register blueprint, blueprint import.

2026-06-22651

managing-bundles

Comfy-Org/workflow_templates

Manages template bundles, categories, and ordering in the ComfyUI template repository. Moves templates between bundles, reorders templates, creates or renames categories. Use when asked to: move a template, change category, reorder templates, organize templates, rearrange templates, group templates, categorize, recategorize, change bundle, switch bundle, sort templates, change template order, reorganize, restructure categories, rename category, create category, update category, curate templates, manage collections. Triggers on: move template, change category, reorder, organize templates, bundle management, template order, category management.

2026-06-22651

managing-thumbnails

Comfy-Org/workflow_templates

Manages thumbnail and preview images for ComfyUI workflow templates. Adds, replaces, validates, and audits thumbnails. Use when asked to: add a thumbnail, replace a preview image, update template image, fix missing thumbnail, check thumbnails, audit thumbnails, which templates need thumbnails, missing previews, add preview image, change template picture, update template visual, swap thumbnail, set thumbnail, upload preview, template image missing, broken thumbnail, thumbnail not showing. Triggers on: thumbnail, preview image, template image, template picture, missing thumbnail, add image, replace image, visual asset.

2026-06-22651

managing-translations

Comfy-Org/workflow_templates

Manages internationalization and translations for ComfyUI workflow templates. Syncs translations, adds new languages, checks translation coverage, and manages locale files. Use when asked to: translate, add translations, sync translations, check translations, missing translations, add a language, localize, internationalize, i18n, update translations, translation status, which templates need translation, language support, sync locales, translate description, translate title, add Chinese, add Japanese, add Spanish, multi-language, multilingual. Triggers on: translate, translation, i18n, locale, language, localize, internationalize, sync translations, missing translations.

2026-06-22651

regenerating-ai-content

Comfy-Org/workflow_templates

Manages AI content generation for the ComfyUI template site. Regenerates descriptions, clears cache, debugs placeholder content, and runs the AI pipeline. Use when asked to: regenerate content, refresh AI content, clear cache, fix placeholder text, re-run AI generation, update generated descriptions, force regenerate, check cache status, debug AI content, why is content missing, content looks wrong, run the AI pipeline, generate descriptions, update AI text, rebuild content, fix generated content, content not showing, stale content, outdated descriptions. Triggers on: regenerate, AI content, clear cache, placeholder, generate descriptions, content pipeline, refresh content, rebuild AI.

2026-02-08651

name

managing-mcp-index

description

Managing MCP Index

What This Is

templates/index.mcp.json is a machine-oriented template index for Comfy Cloud MCP tools. It is separate from:

System	File(s)	Purpose
MCP index (this skill)	`index.mcp.json`	English metadata for AI tool routing: `description`, `io`, `capabilities`, `recommend`
Hub manifest	`index.json` + `index.{locale}.json`	Human UI + 11-language titles/descriptions → skill: `managing-translations`
Site SEO	`site/` AI pipeline	Long-form page copy → skill: `regenerating-ai-content`

MCP descriptions are English only. There is no MCP translation step. Multi-language hub copy uses npm run i18n (sync_data.py), not the MCP pipeline.

Quick Commands (npm)

npm run mcp          # Step 1: sync index.json → index.mcp.json
npm run mcp:check    # Dry-run sync (no write)
npm run mcp:ai       # Step 2b: AI English descriptions (stale templates only)
npm run mcp:models   # Step 2a: AI model profiles in models_registry.json
npm run i18n         # Hub translations (NOT MCP — separate system)

Prerequisites for AI steps: copy .env.example → .env, set AI_API_KEY, AI_BASE_URL, AI_MODEL. Optional: COMFYUI_REPO_PATH for API node dropdown scanning during npm run mcp.

Advanced flags (run Python directly): see scripts/mcp/docs/MCP_AI_ENHANCEMENT.md.

Pipeline Overview

templates/index.json
        │
        ▼  npm run mcp  (sync_index.py)
templates/index.mcp.json  ◄── merge description/io from template_cache (hash match)
        │
        ├── npm run mcp:models  → scripts/data/mcp/models_registry.json
        └── npm run mcp:ai      → scripts/data/mcp/template_cache.json → merge back to index.mcp.json

Step	Script	Writes
1 Sync	`scripts/mcp/sync_index.py`	`index.mcp.json`, refreshes `api_node_model_options.json`
2a Models	`scripts/mcp/enhance_models_registry.py`	`models_registry.json`
2b Templates	`scripts/mcp/enhance_descriptions.py`	`template_cache.json` + merge → `index.mcp.json`

Run 2a before 2b when both are needed. Run sync before AI after adding templates to index.json.

Data Files (`scripts/data/mcp/`)

File	Role
`models_registry.json`	Model profiles: `summary`, `strengths`, `capabilities` (AI context for descriptions)
`template_cache.json`	Per-template `description` + `io`, versioned by `source_hash` (SHA-256 of `templates/{name}.json`)
`template_overrides.json`	Manual `recommend` / `freshness` pins (survives sync)
`api_node_model_options.json`	Scanned ComfyUI API node model dropdowns

Do not mix layers: model copy goes in models_registry.json, template copy in template_cache.json.

Template Cache Versioning

Each cache entry has source_hash = hash of workflow JSON.
Hash match → sync merges cached description / io into index.mcp.json.
Hash mismatch or missing entry → npm run mcp:ai targets that template.
enhance_descriptions.py only updates description; it preserves existing io from cache or MCP entry.

Fields: Who Owns What

Field	Set by	Notes
`name`, `title`, `task`, `model`, `usage`	Sync from `index.json`
`capabilities`, `io` (default)	Sync	`workflow` from tags; `model_options` when single API model node
`freshness`	Sync from `date`	Override via `template_overrides.json`
`recommend`	Sync from `usage` tiers	Override via `template_overrides.json`
`description`, `io` (polished)	`template_cache.json`	AI or manual; hash-gated
`description` (AI only)	`enhance_descriptions.py`	English; references `models_registry.json`

`recommend` tiers (from `usage`)

Usage	Label
≥ 2500	`highly_recommended`
≥ 1000	`top`
≥ 500	`high`
≥ 200	`medium`
≥ 50	`low`
< 50	`not_recommended`

Use Cases category floor: never below low (no not_recommended).

Manual override example (template_overrides.json):

{
  "schema_version": 1,
  "templates": {
    "image_krea2_turbo_t2i": { "recommend": "high" }
  }
}

Common Workflows

After adding or editing templates in `index.json`

npm run mcp:check    # preview added/removed
npm run mcp
npm run mcp:ai       # only if --check shows stale templates (or workflow JSON changed)

After editing a workflow JSON (`templates/foo.json`)

Hash changes → run npm run mcp:ai for that template (or all stale). Optionally:

python3 scripts/mcp/enhance_descriptions.py --template foo

Pin recommend / freshness for a template

Edit scripts/data/mcp/template_overrides.json, then npm run mcp.

Regenerate all MCP descriptions (expensive)

python3 scripts/mcp/enhance_descriptions.py --all

One-time: seed cache from existing MCP copy

python3 scripts/mcp/import_template_cache.py

Sync Exclusions

Categories skipped: Node Basics, LLM, Getting Started
Local-only templates: includeOnDistributions: ["local"] only — not in MCP index
Multi API model nodes: model_options omitted (logged to scripts/.output/sync_index.log)

What NOT To Do

Do not put model profiles in template_cache.json.
Do not expect npm run i18n to update index.mcp.json.
Do not hand-edit index.mcp.json description without updating template_cache.json — next sync overwrites unless cache hash matches.
Do not run enhance_descriptions.py before enhance_models_registry.py when model context is missing for new models.

After Changes

npm run mcp — refresh structured fields and merge cache.
npm run mcp:ai / npm run mcp:models — if AI copy needed.
Commit index.mcp.json and relevant scripts/data/mcp/*.json files.
Bump pyproject.toml version if template assets changed (repo convention).

Reference Docs

Full spec: scripts/mcp/docs/MCP_AI_ENHANCEMENT.md
Script layout: scripts/mcp/README.md
Data files: scripts/data/mcp/README.md

managing-mcp-index

More from this repository

More from this repository

Managing MCP Index

What This Is

Quick Commands (npm)

Pipeline Overview

Data Files (scripts/data/mcp/)

Template Cache Versioning

Fields: Who Owns What

recommend tiers (from usage)

Common Workflows

After adding or editing templates in index.json

After editing a workflow JSON (templates/foo.json)

Pin recommend / freshness for a template

Regenerate all MCP descriptions (expensive)

One-time: seed cache from existing MCP copy

Sync Exclusions

What NOT To Do

After Changes

Reference Docs

Managing MCP Index

What This Is

Quick Commands (npm)

Pipeline Overview

Data Files (scripts/data/mcp/)

Template Cache Versioning

Fields: Who Owns What

recommend tiers (from usage)

Common Workflows

After adding or editing templates in index.json

After editing a workflow JSON (templates/foo.json)

Pin recommend / freshness for a template

Regenerate all MCP descriptions (expensive)

One-time: seed cache from existing MCP copy

Sync Exclusions

What NOT To Do

After Changes

Reference Docs

Data Files (`scripts/data/mcp/`)

`recommend` tiers (from `usage`)

After adding or editing templates in `index.json`

After editing a workflow JSON (`templates/foo.json`)

Data Files (`scripts/data/mcp/`)

`recommend` tiers (from `usage`)

After adding or editing templates in `index.json`

After editing a workflow JSON (`templates/foo.json`)