fix: add missing YAML frontmatter to skill files - #1046
Merged
bradygaster merged 1 commit intoMay 1, 2026
Conversation
Owner
|
@gaburn this ready? |
7 skill SKILL.md files were missing YAML frontmatter entirely, preventing them from loading in the Copilot CLI. Added proper frontmatter blocks with name, description, domain, confidence, and source fields. Ran template sync to propagate the nap skill change and skill-template sync for .squad/skills. The other 7 files listed in the issue already had correct frontmatter on the dev branch, so no changes were needed for those. Closes bradygaster#706 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
gaburn
force-pushed
the
gaburn/706-fix-skill-frontmatter
branch
from
April 30, 2026 22:58
5e9d2df to
5995ec5
Compare
gaburn
marked this pull request as ready for review
April 30, 2026 22:59
Contributor
There was a problem hiding this comment.
Pull request overview
Adds missing YAML frontmatter headers to several SKILL.md files so the skill loader can recognize and parse them reliably across templates and packaged template assets (Fixes #706).
Changes:
- Added YAML frontmatter (
name,description,domain,confidence,source) to multiple skill documents across.copilot/,.squad/, and packaged template directories. - Synced the
napskill change across the template-mirrored locations. - Expanded the
release-processskill content (beyond frontmatter) with additional v0.9.4 incident learnings/checklist updates.
Reviewed changes
Copilot reviewed 20 out of 20 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| templates/skills/nap/SKILL.md | Adds YAML frontmatter to the nap skill template. |
| .squad-templates/skills/nap/SKILL.md | Canonical template updated with matching frontmatter for nap. |
| packages/squad-cli/templates/skills/nap/SKILL.md | Mirrors nap template frontmatter into CLI package templates. |
| packages/squad-sdk/templates/skills/nap/SKILL.md | Mirrors nap template frontmatter into SDK package templates. |
| .copilot/skills/cli-wiring/SKILL.md | Adds missing frontmatter for Copilot-facing cli-wiring skill. |
| .squad/skills/cross-machine-coordination/SKILL.md | Adds missing frontmatter for team skill loading. |
| packages/squad-cli/templates/skills/cross-machine-coordination/SKILL.md | Adds missing frontmatter in CLI template asset. |
| packages/squad-sdk/templates/skills/cross-machine-coordination/SKILL.md | Adds missing frontmatter in SDK template asset. |
| .squad/skills/model-selection/SKILL.md | Adds missing frontmatter for team skill loading. |
| packages/squad-cli/templates/skills/model-selection/SKILL.md | Adds missing frontmatter in CLI template asset. |
| packages/squad-sdk/templates/skills/model-selection/SKILL.md | Adds missing frontmatter in SDK template asset. |
| .squad/skills/personal-squad/SKILL.md | Adds missing frontmatter for team skill loading. |
| packages/squad-cli/templates/skills/personal-squad/SKILL.md | Adds missing frontmatter in CLI template asset. |
| packages/squad-sdk/templates/skills/personal-squad/SKILL.md | Adds missing frontmatter in SDK template asset. |
| .squad/skills/ralph-two-pass-scan/SKILL.md | Adds missing frontmatter for team skill loading. |
| packages/squad-cli/templates/skills/ralph-two-pass-scan/SKILL.md | Adds missing frontmatter in CLI template asset. |
| packages/squad-sdk/templates/skills/ralph-two-pass-scan/SKILL.md | Adds missing frontmatter in SDK template asset. |
| .squad/skills/release-process/SKILL.md | Adds missing frontmatter (and includes broader content updates). |
| packages/squad-cli/templates/skills/release-process/SKILL.md | Adds frontmatter and updates release-process documentation/checklists. |
| packages/squad-sdk/templates/skills/release-process/SKILL.md | Adds frontmatter and updates release-process documentation/checklists. |
Comments suppressed due to low confidence (2)
packages/squad-cli/templates/skills/release-process/SKILL.md:16
- The PR description says this change only adds missing YAML frontmatter, but this file also has substantial additional content edits (new v0.9.4 incident learnings, checklist updates, and new sections). Please either update the PR description to reflect these additional documentation changes, or split the release-process content updates into a separate PR so the frontmatter fix can be reviewed/merged independently.
# Release Process
> Earned knowledge from the v0.9.0→v0.9.1 and v0.9.4 incidents. Every agent involved in releases MUST read this before starting release work.
> See also: `.copilot/skills/release-process/SKILL.md` for the Copilot-facing runbook.
## SCOPE
✅ THIS SKILL PRODUCES:
packages/squad-sdk/templates/skills/release-process/SKILL.md:16
- The PR description says this change only adds missing YAML frontmatter, but this file also contains significant additional content edits (v0.9.4 incident learnings, checklist updates, new sections). Please reflect this in the PR description, or move the non-frontmatter documentation updates into a separate PR for clearer review scope.
# Release Process
> Earned knowledge from the v0.9.0→v0.9.1 and v0.9.4 incidents. Every agent involved in releases MUST read this before starting release work.
> See also: `.copilot/skills/release-process/SKILL.md` for the Copilot-facing runbook.
## SCOPE
✅ THIS SKILL PRODUCES:
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.
Fixes #706 - Added YAML frontmatter to 7 skill SKILL.md files that were missing it. The other 7 files listed in the issue already had correct frontmatter on dev. Ran template sync to propagate changes to packages.