v1.1.7714: Custom skills in ~/.claude/skills/ disappear from / menu after update — frontmatter now required but not documented

Resolved 💬 3 comments Opened Mar 21, 2026 by eMiami Closed Mar 24, 2026

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

  1. Create a skill at ~/.claude/skills/my-skill/SKILL.md without YAML frontmatter (just markdown content)
  2. Skills appear in / menu on older versions
  3. Update to v1.1.7714
  4. 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

  1. Add migration guide / deprecation warning when skills without frontmatter are detected
  2. Document the frontmatter requirement explicitly in the skills documentation
  3. Consider logging a warning when a SKILL.md is found without valid frontmatter rather than silently skipping it

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗