Add YAML frontmatter to all skills for automatic discovery #12

New Issue

2025-12-31T18:06:19Z

HugoNijhuis commented

2025-12-31 18:06:19 +00:00

Summary

The Claude Code skills in ~/.claude/skills/ are not being automatically discovered because they're missing the required YAML frontmatter.

Problem

Skills like gitea, code-review, issue-writing, backlog-grooming, and roadmap-planning all start directly with markdown content instead of the required frontmatter format.

Solution

Add YAML frontmatter to the top of each SKILL.md file:

---
name: <skill-name>
description: <brief description for semantic matching>
---

Affected Skills

~/.claude/skills/gitea/SKILL.md
~/.claude/skills/code-review/SKILL.md
~/.claude/skills/issue-writing/SKILL.md
~/.claude/skills/backlog-grooming/SKILL.md
~/.claude/skills/roadmap-planning/SKILL.md

Notes

The name field must use lowercase letters, numbers, and hyphens only (max 64 chars)
The description field is used for semantic matching when Claude decides which skills to apply
After adding frontmatter, Claude Code needs to be restarted for discovery to work

## Summary The Claude Code skills in `~/.claude/skills/` are not being automatically discovered because they're missing the required YAML frontmatter. ## Problem Skills like `gitea`, `code-review`, `issue-writing`, `backlog-grooming`, and `roadmap-planning` all start directly with markdown content instead of the required frontmatter format. ## Solution Add YAML frontmatter to the top of each SKILL.md file: ```yaml --- name: <skill-name> description: <brief description for semantic matching> --- ``` ## Affected Skills - `~/.claude/skills/gitea/SKILL.md` - `~/.claude/skills/code-review/SKILL.md` - `~/.claude/skills/issue-writing/SKILL.md` - `~/.claude/skills/backlog-grooming/SKILL.md` - `~/.claude/skills/roadmap-planning/SKILL.md` ## Notes - The `name` field must use lowercase letters, numbers, and hyphens only (max 64 chars) - The `description` field is used for semantic matching when Claude decides which skills to apply - After adding frontmatter, Claude Code needs to be restarted for discovery to work

HugoNijhuis referenced this issue from a commit

2025-12-31 18:11:53 +00:00

Add YAML frontmatter to all skills for automatic discovery

HugoNijhuis referenced a pull request that will close this issue

2025-12-31 18:12:05 +00:00

[Issue #12] Add YAML frontmatter to all skills for automatic discovery #13

HugoNijhuis closed this issue

2025-12-31 18:13:15 +00:00

HugoNijhuis referenced this issue from a commit

2026-05-15 09:29:35 +00:00

Add YAML frontmatter to all skills for automatic discovery

Sign in to join this conversation.