Skip to content

fix(skills): move mirror note below frontmatter in budget-negotiator - #452

Open
Tarikv1 wants to merge 1 commit into
cobusgreyling:mainfrom
Tarikv1:fix/budget-negotiator-frontmatter
Open

fix(skills): move mirror note below frontmatter in budget-negotiator#452
Tarikv1 wants to merge 1 commit into
cobusgreyling:mainfrom
Tarikv1:fix/budget-negotiator-frontmatter

Conversation

@Tarikv1

@Tarikv1 Tarikv1 commented Aug 2, 2026

Copy link
Copy Markdown

Problem

skills/budget-negotiator/SKILL.md opens with an HTML comment above the --- frontmatter delimiter:

<!--
  NOTE: This template is a mirror of skills/budget-negotiator/SKILL.md.
  ...
-->
---
name: budget-negotiator
description: An advanced skill for L3 autonomous loops. ...
---

Because --- is not the first line, the YAML frontmatter is never recognised. Claude Code's skill registry loads the skill with no name and advertises its description as the literal string <!--, so budget-negotiator is effectively undiscoverable — the agent can't tell what it's for.

It's the only SKILL.md in the repo with this layout; every other skill starts with --- on line 1.

Fix

Move the note below the frontmatter block. Same content, same file, just after the closing ---.

Applied to both skills/budget-negotiator/SKILL.md and templates/SKILL.md.budget-negotiator, since the note itself requires the two to stay byte-identical. Trailing whitespace on the comment lines is dropped in both so they still match exactly (also satisfies markdownlint MD009).

Verification

Both files parse:

skills/budget-negotiator/SKILL.md    -> frontmatter OK: name: budget-negotiator
templates/SKILL.md.budget-negotiator -> frontmatter OK: name: budget-negotiator

And remain byte-identical — md5sum on both: 7715893e316710fc26b8fb4faa7a937a.

Body content is unchanged; the diff is header reordering only.

🤖 Generated with Claude Code

The HTML comment sat above the opening `---`, so the YAML frontmatter was
never recognised. Claude Code's skill registry loaded the skill with no
`name` and advertised `description: <!--`, so the skill was effectively
undiscoverable.

Move the note below the frontmatter block in both the skill and its
template mirror, and drop the trailing whitespace on the comment lines so
the two files remain byte-identical as the note itself requires.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Tarikv1
Tarikv1 requested a review from cobusgreyling as a code owner August 2, 2026 15:09
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