URL of the page with the issue
https://geminicli.com/docs/cli/tutorials/skills-getting-started/
What is the problem?
Hey team, I noticed that the tutorial currently says Gemini “automatically discovers skills,” but it doesn’t explain what a user should do if a skill doesn’t appear in /skills list.
Common problems that beginners might run into include:
Mis-typed skill directory or filename
Incorrect folder structure
Wrong case in filenames
It would be really helpful to add a short troubleshooting section that covers these scenarios, e.g.:
❌ “Skill not found” → Verify .gemini/skills//SKILL.md exists
❌ Wrong name → Ensure skill directory name matches name field in SKILL.md
This would make onboarding smoother and reduce confusion for new users.
What did you expect to happen?
This would make onboarding smoother and reduce confusion for new users.
gemini skills list
my skill doesn’t show up. There’s no error message or guidance in the tutorial, so it’s unclear why the skill wasn’t discovered.
What I expected:
The tutorial should either explain common causes for skill discovery failure or show how to verify/validate a skill.
A new skill should appear in /skills list if the folder structure and SKILL.md are correct.
Clear troubleshooting tips, e.g.:
Additional context
No response
URL of the page with the issue
https://geminicli.com/docs/cli/tutorials/skills-getting-started/
What is the problem?
Hey team, I noticed that the tutorial currently says Gemini “automatically discovers skills,” but it doesn’t explain what a user should do if a skill doesn’t appear in /skills list.
Common problems that beginners might run into include:
Mis-typed skill directory or filename
Incorrect folder structure
Wrong case in filenames
It would be really helpful to add a short troubleshooting section that covers these scenarios, e.g.:
❌ “Skill not found” → Verify .gemini/skills//SKILL.md exists
❌ Wrong name → Ensure skill directory name matches
namefield in SKILL.mdThis would make onboarding smoother and reduce confusion for new users.
What did you expect to happen?
This would make onboarding smoother and reduce confusion for new users.
gemini skills list
my skill doesn’t show up. There’s no error message or guidance in the tutorial, so it’s unclear why the skill wasn’t discovered.
What I expected:
The tutorial should either explain common causes for skill discovery failure or show how to verify/validate a skill.
A new skill should appear in /skills list if the folder structure and SKILL.md are correct.
Clear troubleshooting tips, e.g.:
Additional context
No response