conditional-activation

Installation
SKILL.md

Conditional Skill Activation

Skills can declare their own activation conditions using YAML frontmatter fields. The skill-activation-filter.sh script reads these fields and emits a filtered skill list based on the current runtime environment.

Why This Exists

Not every skill makes sense in every environment. A duckduckgo-search skill only helps if the ddg binary is installed. A macos-screenshot skill should only appear on macOS. Conditional activation lets the skill-index stay honest without manually curating per-host lists.

Frontmatter Fields

Add any of these to your SKILL.md YAML frontmatter:

Installs
2
GitHub Stars
4
First Seen
Apr 7, 2026