fix: rename skill.md to SKILL.md so the flagship skill loads on Linux#13
Open
gkastanis wants to merge 1 commit into
Open
fix: rename skill.md to SKILL.md so the flagship skill loads on Linux#13gkastanis wants to merge 1 commit into
gkastanis wants to merge 1 commit into
Conversation
…s discovered Claude Code's skill discovery looks for SKILL.md (per the Agent Skills spec); the lowercase skill.md is never found on case-sensitive filesystems, so the flagship website-to-components flow runs with 'Error: Unknown skill' and the agent proceeds without the canonical process and QA gates - silently. All nine sibling skills already use the uppercase name. On macOS's case-insensitive default filesystem the lowercase name is masked, which is likely why this never surfaced. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
.claude/skills/website-to-components/skill.mdis lowercase. Claude Code's skill discovery looks forSKILL.md(per the Agent Skills spec), so on case-sensitive filesystems (any Linux host or container) the add-on's flagship skill is never found. Invoking the documented "clone this website" flow yields:and the agent then proceeds without the skill's canonical process and QA gates — silently, since nothing stops the run.
All nine sibling skills in
.claude/skills/already use the uppercase name; this is the only lowercase one.Why this likely never surfaced upstream: on macOS's case-insensitive default filesystem the lowercase name still resolves, so the bug is invisible there and only bites Linux users.
Fix
One-line rename,
git mv skill.md SKILL.md. (install.yamllists the skill directory, not the file, so no other change is needed.)Testing
Reproduced and fixed on a real install today (2026-07-15): before the rename the agent reported the unknown-skill error; after renaming and restarting the session, the skill loaded and drove a full homepage migration end to end.
Found while standing up an eval environment for the Canvas migration tooling. Sibling PR from the same sweep: #12.
🤖 Generated with Claude Code