Locate the failure before editing
| Observation | Investigate |
|---|---|
| Not in the available-Skills list | Directory, folder depth, header and environment |
| Listed but not selected | Task wording, description and agent settings |
| Another Skill is selected | Overlapping descriptions or duplicate packages |
| Selected but execution fails | Inputs, 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.
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.
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
Not as a first step. Check the documented name rules and ensure the instructions, folder and header remain consistent.
Some agents can combine capabilities. For diagnosis, begin with one explicitly selected Skill so the failure is easier to locate.
Reviewed October 18, 2026 · HowAI editorial
Found something unclear? Send feedback