What is the recommended length for a skill description?

For optimal readability and model processing, descriptions should be kept under 200 characters and start with a clear, active verb describing the skill's purpose.

Why isn't my Claude Code skill being called automatically?

Skills often fail to trigger if the description is too vague or doesn't match common user language. Skill Activator helps you add specific trigger phrases that align with how users actually ask for tasks.

How do I prevent a skill from triggering at the wrong time?

You can narrow the scope by adding specific 'Use when' scenarios and 'Don't use when' exclusions in your skill's YAML metadata to increase relevance signals.

Can I force a skill to be manual-only?

Yes, by setting 'disable-model-invocation' to true, you ensure the skill is only triggered when a user explicitly calls it via a command like /skill-name.

Skill Activator

Name: Skill Activator
Author: xmgrex

byxmgrex

0•

开发者工具

Optimizes Claude Code skill discoverability by standardizing trigger phrases and invocation logic.

Skill Activator provides a structured framework for designing highly effective skill metadata, focusing on trigger phrase engineering and situational specificity. It helps developers move beyond vague descriptions by implementing a proven formula that combines functional scope, situational context, and varied user language patterns. This ensures that Claude invokes the right capability at the right moment while preventing irrelevant triggers, ultimately improving the reliability and performance of custom AI-driven workflows.

主要功能

01Standardized description formula for consistent metadata

02Trigger phrase design patterns that match natural user language

03Invocation audit checklist to verify skill discovery

04Exclusion logic strategies using 'Don't use when' parameters

05Debugging guide for troubleshooting silent or misfired skills

060 GitHub stars

使用场景

01Refining skill scope to prevent accidental model invocations

02Improving the discovery rate of new custom Claude Code skills

03Fixing skills that fail to activate during natural language conversations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xmgrex/ccx-arsenal skill-activator

For use in Claude.ai and ChatGPT

Download Skill