Describe the Bug Custom skills do not trigger via natural language keywords in the CLI, even when “When to Use” instructions are explicitly defined. The exact same skill and prompt work perfectly in the Cursor GUI. In the CLI, the agent ignores the intent unless I manually invoke the skill using the slash command (e.g., /$create-jira-task).
Steps to Reproduce
Create a custom skill (e.g., create-jira-task) with a .md file.
Add a ## When to Use section with natural language triggers (e.g., “Use this skill when the user says ‘create task’”).
Open the Cursor CLI.
Type a trigger phrase like “Let’s open a Jira ticket.”
Observe that the agent does not trigger the tool and responds generically.
Expected Behavior The CLI agent should parse the “When to Use” instructions and automatically trigger the skill when the user types a relevant phrase, matching the behavior of the GUI agent.
IDE:2.4.22 (Universal)VSCode Version: 1.105.1CLI:CLI Version 2026.01.28-fd13201
Additional Information For context, here is the specific configuration I am using that works in the GUI but fails in the CLI:
Markdown
## When to Use
- Use this skill when the user wants to create a Jira task or ticket
- Use this skill when the user says "create task", "new ticket", or "open a Jira"
- This skill is helpful for structuring tasks with proper titles, descriptions, and epic linking
For AI issues: which model did you use?
Model name (e.g., Sonnet 4, Tab…)
For AI issues: add Request ID with privacy disabled
Request ID: f9a7046a-279b-47e5-ab48-6e8dc12daba1
For Background Agent issues, also post the ID: bc-…
Additional Information
Add any other context about the problem here.
Does this stop you from using Cursor?
Yes - Cursor is unusable
Sometimes - I can sometimes use Cursor
No - Cursor works, but with this issue
The more details you provide, the easier it is for us to reproduce and fix the issue. Thanks!
Hey, thanks for the report. I can see the screenshots. It works fine in the GUI, but the CLI is ignoring the “When to Use” triggers.
You set everything up correctly according to the official docs. The “When to Use” section is meant for exactly this. Skills support in the CLI was added just last week, and it looks like automatic context detection still isn’t working. The only workaround for now is to trigger it manually with /create-jira-task.