USING SKILLS

Help your agent choose the intended Skill

Separate discovery from invocation, test explicit selection and diagnose why a normal request chooses another method.

Locate the failure before editing

ObservationInvestigate
Not in the available-Skills listDirectory, folder depth, header and environment
Listed but not selectedTask wording, description and agent settings
Another Skill is selectedOverlapping descriptions or duplicate packages
Selected but execution failsInputs, dependencies and permissions

Reinstalling is useful only when the files or target are wrong. It will not fix a missing service credential or a task description that matches a different capability.

Test explicit selection first

Use your agent's Skill picker or supported name syntax. Check the name in the installed instructions rather than assuming the catalog slug is the invocation name. Agent interfaces differ; the agent guides show the appropriate starting point.

Diagnostic request
Use the selected Skill for this task.
Tell me which instructions you loaded and which inputs are missing.
Do not run external tools until you have identified the requirements.

Then try a normal task request using the same inputs. If only the explicit request works, the package can be discovered; the remaining issue is selection, not installation.

Improve descriptions in a Skill you maintain

Describe the job, relevant inputs and the situation that calls for the method. Avoid claiming that one Skill handles every kind of design, research or automation.

Example description
Prepare a weekly project-update deck from a supplied brief,
completed-work notes and risks. Use when the user needs a concise
internal status presentation with evidence and next decisions.

Use a small selection test set

  • One request that should select the Skill.
  • One nearby task that should use a different method.
  • One request missing a required input.
  • One explicit selection using a complete brief.

Check which method was loaded and what happened. Do not judge automatic selection from one successful answer. Keep the tests when you update descriptions or install another overlapping Skill.

FAQ

Reviewed October 18, 2026 · HowAI editorial

Found something unclear? Send feedback