Repository navigation
Add YAML frontmatter to 28 skills for reliable auto-discovery - #68
Open
DigitalPritam1 wants to merge 1 commit into
Open
DigitalPritam1 wants to merge 1 commit into
DigitalPritam1 wants to merge 1 commit into
Conversation
28 SKILL.md files shipped without YAML frontmatter, opening instead with an '# SKILL: ...' H1 and a '## Description' section. Claude Code's skill loader keys auto-discovery off the YAML 'name'/'description' fields, so these skills fell back to their H1 as the description and triggered weakly compared to the 51 skills that already had frontmatter. This adds a '---' frontmatter block to each, with: - name: the skill's directory slug (matches the loader's expectation) - description: synthesized from the file's existing '## Description' plus its '## Trigger Phrases' keywords, so routing matches the original intent Bodies are untouched; every change is a pure prepend. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.
What
Adds YAML frontmatter to the 28
SKILL.mdfiles that currently ship without it. These skills open directly with an# SKILL: ...H1 and keep their metadata in a## Description/## Trigger Phrasessection, while the other 51 skills already have proper---frontmatter.Why
Claude Code's skill loader keys auto-discovery off the YAML
nameanddescriptionfields. Without frontmatter, these 28 skills fall back to their H1 (e.g. justSKILL: Server-Side Request Forgery (SSRF)) as the description the router sees, so they auto-trigger far more weakly than the rich paragraph sitting in their own## Descriptionblock. They load fine when invoked by name, but the model is less likely to reach for them autonomously.Installing per the README (
git clone ... ~/.claude/skills/claude-red) also nests skills atSkills/<category>/<name>/SKILL.md, two levels below where the loader scans, so strong frontmatter matters even more once they're symlinked/flattened to the top level.How
For each of the 28 files:
name: the skill's directory slug (what the loader expects).description: synthesized from the file's existing## Descriptiontext, with the## Trigger Phraseskeywords appended asUse when the task involves: ...so routing matches the original author intent.Bodies are untouched. Every change is a pure prepend: 140 insertions, 0 deletions, across 28 files.
Verification
name+descriptionfrontmatter (was 51/79).offensive-ssrf,offensive-xss,offensive-edr-evasion) — full methodology bodies intact.🤖 Generated with Claude Code