Answer: If Claude doesn't use your skill when expected, check that the description includes keywords users would naturally say, verify the skill appears in `What skills are available?`, try rephrasing your request to match the description more closely, and invoke it directly with `/skill-name` if the skill is user-invocable. If the frontmatter YAML is malformed, Claude Code loads the skill body with empty metadata, so `/skill-name` still works but Claude can't match against your `description`. Status: Confirmed Entry: tool/claude-code/troubleshooting/skill-not-triggering Revision: 5 Digest: sha256:001c2d135ae4255f (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:53Z Last changed: 2026-11-20T12:25:37Z (verify skill availability: — → Verify the skill appears in `What skills are available?`) Last verified: 2026-11-20T12:25:37Z Next check: 2026-11-21T12:25:37Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of first troubleshooting step | Check the description includes keywords users would naturally say | [1] | 2026-11-20 verify skill availability | Verify the skill appears in `What skills are available?` | [1] | 2026-11-20 direct invocation | Invoke it directly with `/skill-name` if the skill is user-invocable | [1] | 2026-11-20 malformed frontmatter effect | Claude Code loads the skill body with empty metadata | [1] | 2026-11-20 debug flag | --debug | [1] | 2026-11-20 minimum version for validate | v2.1.233 | [1] | 2026-11-20 Sources: [1] Anthropic. "Extend Claude with skills". https://code.claude.com/docs/en/skills.md Role: primary. Accessed: 2026-11-20T12:25:37Z Quote: "Check the description includes keywords users would naturally say" (Supports: first troubleshooting step) Quote: "Verify the skill appears in `What skills are available?`" (Supports: verify skill availability) Quote: "Invoke it directly with `/skill-name` if the skill is user-invocable" (Supports: direct invocation) Quote: "If the frontmatter YAML is malformed, Claude Code loads the skill body with empty metadata" (Supports: malformed frontmatter effect) Quote: "Run with `--debug` to see the parse error." (Supports: debug flag) Quote: "Requires Claude Code v2.1.233 or later." (Supports: minimum version for validate) Published: 2026-11-20T02:52:07Z Snapshot SHA-256: 8b6666f0221930a2f5fc500adad91ae317e71921ee2905336837213bfa388fb5 (captured 2026-11-20T12:25:35Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:25:37Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:25:37Z Last attempt: 2026-11-20T12:25:37Z Notes and limitations: Extracted automatically from a single official source (section "Skill not triggering"). Related: https://latestn.com/tool/claude-code/troubleshooting/slack-repo-not-showing Why isn't my repository showing in Claude Code in Slack? https://latestn.com/tool/claude-code/troubleshooting/sso-auth-loop-troubleshooting How do I troubleshoot authentication loops with SSO and corporate proxies in Claude Code on Amazon Bedrock? https://latestn.com/tool/claude-code/troubleshooting/status-line-troubleshooting Why is my Claude Code status line not appearing or showing empty values? https://latestn.com/tool/claude-code/troubleshooting/scheduled-tasks-limitations What are the limitations of session-scoped scheduled tasks in Claude Code? https://latestn.com/tool/claude-code/troubleshooting/screen-reader-limitations What are the known limitations of using Claude Code with a screen reader? https://latestn.com/tool/claude-code/troubleshooting/simulator-pane-not-opening Why doesn't the iOS Simulator pane open when Claude runs my app in Claude Code? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T12:25:37Z | changed | verify skill availability: — → Verify the skill appears in `What skills are available?` | [1] 2026-11-20T12:25:37Z | changed | direct invocation: /skill-name → Invoke it directly with `/skill-name` if the skill is user-invocable | [1] 2026-11-17T12:31:38Z | changed | debug flag: — → --debug | [1] 2026-11-17T12:31:38Z | changed | malformed frontmatter effect: — → Claude Code loads the skill body with empty metadata | [1] 2026-11-17T12:31:38Z | changed | first troubleshooting step: — → Check the description includes keywords users would naturally say | [1] 2026-11-17T12:31:38Z | changed | malformed frontmatter: Claude Code loads the skill body with empty metadata → — | [1] 2026-11-17T12:31:38Z | changed | paths restriction: The skill doesn't activate for files outside it → — | [1] 2026-11-17T12:31:38Z | changed | direct invocation: Invoke it directly with `/skill-name` if the skill is user-invocable → /skill-name | [1] 2026-11-17T12:31:38Z | changed | rephrasing: Try rephrasing your request to match the description more closely → — | [1] 2026-11-17T12:31:38Z | changed | skill availability check: Verify the skill appears in `What skills are available?` → — | [1] 2026-11-17T12:31:38Z | changed | description keywords: Check the description includes keywords users would naturally say → — | [1] 2026-11-15T12:25:54Z | changed | malformed frontmatter: — → Claude Code loads the skill body with empty metadata | [1] 2026-11-15T12:25:54Z | changed | paths restriction: — → The skill doesn't activate for files outside it | [1] 2026-11-15T12:25:54Z | changed | rephrasing: — → Try rephrasing your request to match the description more closely | [1] 2026-11-15T12:25:54Z | changed | skill availability check: — → Verify the skill appears in `What skills are available?` | [1] 2026-11-15T12:25:54Z | changed | description keywords: — → Check the description includes keywords users would naturally say | [1] 2026-11-15T12:25:54Z | changed | debug flag: --debug → — | [1] 2026-11-15T12:25:54Z | changed | malformed frontmatter effect: Claude Code loads the skill body with empty metadata → — | [1] 2026-11-15T12:25:54Z | changed | verification step: Verify the skill appears in `What skills are available?` → — | [1] 2026-11-15T12:25:54Z | changed | first troubleshooting step: Check the description includes keywords users would naturally say → — | [1] 2026-11-14T12:21:16Z | changed | malformed frontmatter effect: — → Claude Code loads the skill body with empty metadata | [1] 2026-11-14T12:21:16Z | changed | verification step: — → Verify the skill appears in `What skills are available?` | [1] 2026-11-14T12:21:16Z | changed | malformed YAML effect: Claude Code loads the skill body with empty metadata → — | [1] 2026-11-14T12:21:16Z | changed | paths limitation: The skill doesn't activate for files outside it → — | [1] 2026-11-14T12:21:16Z | changed | direct invocation: /skill-name → Invoke it directly with `/skill-name` if the skill is user-invocable | [1] 2026-11-13T03:05:53Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/troubleshooting/skill-not-triggering/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/troubleshooting/skill-not-triggering POST: https://latestn.com/dispute/tool/claude-code/troubleshooting/skill-not-triggering with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/troubleshooting/skill-not-triggering?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). Why is my Claude Code skill not triggering? Revision 5, last verified 2026-11-20T12:25:37Z. https://latestn.com/tool/claude-code/troubleshooting/skill-not-triggering (accessed 2026-11-21T09:54:40Z). @misc{LatestN_tool_claude_code_troubleshooting_skill_not_triggering_r5, title = {Why is my Claude Code skill not triggering?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/troubleshooting/skill-not-triggering}}, note = {Revision 5; digest sha256:001c2d135ae4255f; last verified 2026-11-20T12:25:37Z; accessed 2026-11-21T09:54:40Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/troubleshooting/skill-not-triggering