flowmade-one/architecture
3
0
Fork 0
Code Issues 15 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add YAML frontmatter to all skills for automatic discovery #12

New Issue
Closed
opened 2025-12-31 18:06:19 +00:00 by HugoNijhuis · 0 comments
HugoNijhuis commented 2025-12-31 18:06:19 +00:00
Owner
Copy Link

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
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
HugoNijhuis fluxcd-bot renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: flowmade-one/architecture#12
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?