Repository navigation
Rewrite skill descriptions with triggers and example requests - #12
Merged
Merged
Conversation
Give every skill a third-person description that says what it does, when to use it, and quotes example requests, so Claude can match the user's wording to the right skill. Keep the metadata in description only, since claude.ai rejects the when_to_use field. Reframe mimi-cbt as CBT-informed self-help rather than therapy. Add a lint warning for descriptions without an example request. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01N6QLSr7Xy6yQNtiWmjghNz
There was a problem hiding this comment.
🟡 Changes recommended
Unresolved safety, trigger-scope, and lint-validation issues remain.
3 open issues
What changed in this PR
Rewrites all 16 skill descriptions with consistent triggers and example requests, and updates lint documentation.
Changes:
- Standardizes skill descriptions and examples.
- Adds quoted-example lint warnings.
- Documents the updated requirement in
README.md.
| File | Review result |
|---|---|
scripts/lint-plugins.py |
Moderate (2 votes): validate examples specifically; Moderate (1 vote): handle escaped quotes. |
README.md |
No findings. |
plugins/soft-skills/skills/mimi-tutor/SKILL.md |
No findings. |
plugins/soft-skills/skills/mimi-rephrase/SKILL.md |
No findings. |
plugins/soft-skills/skills/mimi-notes-summary/SKILL.md |
Nit (3 votes): replace real name “Sarah” with a generic placeholder. |
plugins/soft-skills/skills/mimi-edit/SKILL.md |
No findings. |
plugins/mimi-core/skills/write-readme/SKILL.md |
No findings. |
plugins/mimi-core/skills/mimi-world/SKILL.md |
Moderate (1 vote): narrow the broad work-related trigger. |
plugins/mimi-core/skills/check-beehive/SKILL.md |
No findings. |
plugins/mimi-core/skills/audit-mimis-imac/SKILL.md |
No findings. |
plugins/life-skills/skills/mimi-cbt/SKILL.md |
Critical (1 vote): add explicit crisis and emergency escalation guidance. |
plugins/life-skills/skills/daily-decision-maker/SKILL.md |
No findings. |
plugins/life-skills/skills/check-gmail/SKILL.md |
No findings. |
plugins/craft-skills/skills/run-tarot-reading/SKILL.md |
No findings. |
plugins/craft-skills/skills/mimi-sprite-studio/SKILL.md |
No findings. |
plugins/craft-skills/skills/get-astro-today/SKILL.md |
No findings. |
plugins/code-skills/skills/mimi-pr-review/SKILL.md |
No findings. |
plugins/code-skills/skills/depth-breakdown/SKILL.md |
No findings. |
Review effort: Lite
| name: mimi-cbt | ||
| description: Contains steps, guardrails and guidance in performing Cognitive Behavior Therapy on the user. Use this skill to roleplay as user's mental health therapist to assist trauma recovery. | ||
|
|
||
| description: Guides the user through CBT-informed (cognitive behavioural therapy) self-help exercises with clear guardrails, such as noticing thoughts, spotting thinking traps and reframing them. This is supportive reflection, not a replacement for a professional therapist or crisis care. Use when the user wants to work through anxious, negative or stuck thoughts, or asks for a CBT exercise. Examples include "help me reframe this thought", "I keep thinking I'll fail", "walk me through a thought record" and "I feel overwhelmed, can we do a CBT exercise?". |
Comment on lines
+149
to
+150
| if not re.search(r'"[^"]+"', description): | ||
| warn(skill_md, 'description should quote one or more example requests, e.g. Examples include "..."') |
| --- | ||
| name: mimi-notes-summary | ||
| description: Turn rough notes, a recorded or narrated conversation, or an assigned task into a tidy one-page summary in a fixed four-section format (Decisions, Open questions, Action items, Dates). Use when the user pastes meeting notes, a call recap, a transcript, standup notes or a task brief and asks to "summarise", "tidy up", "write up", "recap", or "turn these notes into a summary". | ||
| description: Turns rough notes, a recorded or narrated conversation, or an assigned task into a tidy one-page summary with four fixed sections (Decisions, Open questions, Action items, Dates), giving every action item an owner and due date or TBD. Use when the user pastes meeting notes, a call recap, a transcript, standup notes or a task brief and wants it tidied up. Examples include "summarise these meeting notes", "write up my call with Sarah", "recap this transcript" and "turn these notes into action items". |
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
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.
Summary
Rewrite the
descriptionof all 16 skills in one consistent shape, so Claude can match the user's wording to the right skill:Each description is 399–547 characters (limit 1,024).
Why only
description: Claude Code also supports awhen_to_usefield, but claude.ai uploads and the Skills API reject it with a hard error, and these skills are also used on claude.ai.Other changes:
mimi-cbtis now described as CBT-informed self-help exercises, explicitly not a replacement for a therapist or crisis care.check-gmaildescription is clearer about needing the Gmail connector.scripts/lint-plugins.pywarns when a description quotes no example request; README's Checks section updated.Note: the five skills synced from claude.ai (
audit-mimis-imac,depth-breakdown,daily-decision-maker,get-astro-today,run-tarot-reading) now differ from the claude.ai copies in their description only.Verification
yaml.safe_dump, so quoting is always valid).scripts/lint-plugins.py: 0 errors, 0 warnings.claude plugin validate --strictpasses for the marketplace and all five plugins.ruff,shellcheckand the README tree check pass.Generated by Claude Code