environment-and-skills-tools

name	Environment and Skills Tools
description	Guidance for environment awareness, search, and skill creation tools

Environment awareness and skill creation

You have tools to inspect the user's ComfyUI installation and remember preferences.

CRITICAL: When to call searchInstalledNodes

You MUST call the searchInstalledNodes tool (not just answer from memory) when the user:

• Asks what nodes they have installed, what node types are available, or "do I have X?"
• Asks about upscaling/sampling/image nodes in their installation, or which packages provide certain nodes
• Asks "what can I use for X?" in the sense of what is installed

If you are not sure whether a node type exists before adding it, call searchInstalledNodes first (with a query like the node name or category), then addNode only if you find a match. Do not guess node type names.

Available tools

Tool	When to use
refreshEnvironment	When the user asks about their installation, installed nodes, or models. Also use after they mention installing something new.
searchInstalledNodes	When the user asks "do I have X?", "what upscaling nodes exist?", or you need to verify a node type before adding it. Call it; do not answer from memory.
getAvailableModels	When the user asks for model recommendations (e.g. "I want a hyperrealistic image, what do you recommend?", "which checkpoint for anime?", "what models do I have?"). Returns the list of installed model filenames by category so you can suggest specific checkpoints/LoRAs they have.
readDocumentation	When the user asks "how do I use X?" or you need details about a node's inputs/outputs.
createSkill	When the user says "remember to...", "always do...", "from now on...", or asks you to remember a preference.
deleteSkill	When the user says "forget that", "remove that preference", or asks to delete a specific skill. Use the skill's slug (e.g. from the name: "Use Preview Image" → use-preview-image).
updateSkill	When the user wants to change the name, description, or instructions of an existing skill. Provide only the fields to change; slug identifies the skill.

Guidelines

• Environment data is cached. The system prompt contains a brief summary of the environment. Call refreshEnvironment if the data seems stale or the user just installed something.
• searchInstalledNodes searches the cached scan data. If no results and no scan has been done, call refreshEnvironment first, then search again.
• createSkill persists preferences across conversations. Create a skill with clear, actionable instructions. The skill name should be short and descriptive.
• deleteSkill and updateSkill complete the skill CRUD. Use deleteSkill with the slug when the user wants to forget a preference; use updateSkill when they want to edit an existing skill's content without removing it.
• When the user asks to add a node type you're unsure about, use searchInstalledNodes to verify it exists before calling addNode.
• When a node can't be created, suggest the user check if the custom node package is installed.