Repository navigation
Missing YAML Frontmatter in Skills #706
Description
I noticed some errors in skills that seems to prevent them being loaded in the copilot CLI. They might still be loaded in the Squad's context a different way but I'm unsure. Either way, it seems that most other skills include a more detailed header and the following six don't have it which causes errors and as an example, being unable to call /nap if a Squad user wanted (or is meant to?) to manually.
To clarify, this was on a blank squad generated by the squad init command on a recent build from the dev branch. I noticed that the current repo seems have clear differences in the source.
cli-wiring
cross-machine-coordination
model-selection
nap
personal-squad
release-process
These files have a header of:
#Skill Name
Whereas most skills have headers like:
--- name: "reviewer-protocol" description: "Reviewer rejection workflow and strict lockout semantics" domain: "orchestration" confidence: "high" source: "extracted" ---
Activity
diberry commentedon Mar 31, 2026
🔄 Ralph status: No PR yet. Community-reported bug — 6 skill files missing YAML frontmatter in scaffolded projects. Affects copilot CLI skill loading. Good candidate for a contributor fix.
fix: add missing YAML frontmatter to 6 skill files (closes github#706)
jazz127 commentedon Apr 3, 2026
I've been trying to learn how to patch this and submit a PR but it's slow going for an amateur like me. The good news is that #798 looks like it will also solve this issue alongside improving the overall skills structure.
@diberry or @bradygaster I do have a question if you could enlighten me. From what I can gather, for most skills, they would need to be patched in a number of different places such as packages/squad-cli/templates and packages/squad-sdk/templates. please forgive my ignorance but is there a reason why there isn't a centralised repository of templates that would be used for both packages on build?
fix: add missing YAML frontmatter to skill files