v1.1.7714: Custom skills in ~/.claude/skills/ disappear from / menu after update — frontmatter now required but not documented
Version
Claude for Mac v1.1.7714 (3bd6f6)
Description
After updating to v1.1.7714, all custom skills in ~/.claude/skills/ stopped appearing in the / slash command menu. Only built-in commands (/schedule, /clear, /export) were visible.
Root Cause
Skills were working correctly in the previous version without YAML frontmatter in SKILL.md. After the update, frontmatter appears to be required for skill discovery:
---
name: skill-name
description: What the skill does
---
Skills without this block at the top of SKILL.md are silently ignored — no error, no warning, just missing from the menu.
Steps to Reproduce
- Create a skill at
~/.claude/skills/my-skill/SKILL.mdwithout YAML frontmatter (just markdown content) - Skills appear in
/menu on older versions - Update to v1.1.7714
- Skills disappear from
/menu
Fix
Add YAML frontmatter to the top of each SKILL.md file. Skills immediately reappear.
Impact
High — all users with pre-existing custom skills silently lose them after update with no error or migration guidance. This is a breaking change with no warning.
Request
- Add migration guide / deprecation warning when skills without frontmatter are detected
- Document the frontmatter requirement explicitly in the skills documentation
- Consider logging a warning when a
SKILL.mdis found without valid frontmatter rather than silently skipping it
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗