add-model-page

Adds, updates, or removes model page entries on the Comfy Org website via pull requests.

2.0k|679|Updated Jun 13, 2024
One-click install
npx skills add https://github.com/Comfy-Org/ComfyUI_frontend --skill add-model-page
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-model-page
Source: https://github.com/Comfy-Org/ComfyUI_frontend/tree/main/.claude/skills/add-model-page
Command: npx skills add https://github.com/Comfy-Org/ComfyUI_frontend --skill add-model-page

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintaining model pages on the Comfy Org website requires manually editing generated JSON configs, metadata overrides, and creating pull requests, which is repetitive and error-prone.

Core Features & Use Cases

  • Add Model Pages: Regenerate generated-models.json from workflow templates and register new partner/API models via API_PROVIDER_MAP in generate-models.ts.
  • Update & Remove Entries: Edit model-metadata.ts overrides (docsUrl, blogUrl, featured) or remove entries with canonical slug redirects.
  • Automated PR Creation: Verify changes with pnpm typecheck, then branch, commit, and open a GitHub PR with a structured description.
  • Use Case: When a new partner model like flux1-dev launches, run the skill to regenerate the models JSON, add metadata overrides, and open a PR with a Vercel preview link.

Quick Start

Add a model page for flux1-dev on the Comfy Org website and open a pull request with the changes.

Frequently Asked Questions about add-model-page

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a model page to the Comfy Org website?

Run `pnpm tsx apps/website/scripts/generate-models.ts` to regenerate generated-models.json from workflow templates, then add any docsUrl or featured overrides in model-metadata.ts. Commit the changes on a new branch and open a PR with gh pr create.

How do I add a partner or API model not in workflow templates?

Add an entry to the API_PROVIDER_MAP in apps/website/scripts/generate-models.ts with the model name and slug, then re-run the generator script. The model will appear in generated-models.json automatically without local files.

What files need editing to update an existing model page?

Most updates only require editing model-metadata.ts for docsUrl, blogUrl, or featured flags. For displayName or directory changes, edit generated-models.json directly or fix the source in generate-models.ts so regeneration preserves the change.

Why does typecheck fail after adding a model page?

Typecheck fails when a new directory value is not in the ModelDirectory union type or when generated-models.json does not match the OutputModel shape. Add the new directory to the union type or fix the JSON structure before pushing.

What happens if the model slug already exists when adding?

The skill automatically switches to the update flow when a matching slug is found during an add action. For update or remove actions with no matching slug, it stops and asks the user to confirm the model name.