Skip to content

Add YAML frontmatter to 28 skills for reliable auto-discovery - #68

Open
DigitalPritam1 wants to merge 1 commit into
SnailSploit:mainfrom
DigitalPritam1:add-frontmatter-28-skills
Open

DigitalPritam1 wants to merge 1 commit into
SnailSploit:mainfrom
DigitalPritam1:add-frontmatter-28-skills

Conversation

@DigitalPritam1

Copy link
Copy Markdown

What

Adds YAML frontmatter to the 28 SKILL.md files that currently ship without it. These skills open directly with an # SKILL: ... H1 and keep their metadata in a ## Description / ## Trigger Phrases section, while the other 51 skills already have proper --- frontmatter.

Why

Claude Code's skill loader keys auto-discovery off the YAML name and description fields. Without frontmatter, these 28 skills fall back to their H1 (e.g. just SKILL: 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 ## Description block. 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 at Skills/<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 ## Description text, with the ## Trigger Phrases keywords appended as Use 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

  • All 79 skills now parse with valid name + description frontmatter (was 51/79).
  • Spot-loaded affected skills (offensive-ssrf, offensive-xss, offensive-edr-evasion) — full methodology bodies intact.

🤖 Generated with Claude Code

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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant