Skip to content

fix: lowercase the skill name in skill.md frontmatter - #337

Merged
jonoirwinrsa merged 1 commit into
masterfrom
fm/gtm-docs-skill-name-lowercase
Sep 1, 2026
Merged

jonoirwinrsa merged 1 commit into
masterfrom
fm/gtm-docs-skill-name-lowercase

Conversation

@mathew-builds

@mathew-builds mathew-builds commented Sep 1, 2026 •

Copy link
Copy Markdown
Collaborator

What changed

One token, on line 2 of the root skill.md frontmatter:

 ---
-name: Cerebrium
+name: cerebrium
 description: >-

Nothing else in the file is touched — description, body, wrapping, and the mintlify-proj / version keys are all unchanged.

Why

The Agent Skills spec requires a lowercase name, and the current capitalised value makes the published skill fail validation outright.

This also realigns the file with its source of truth: skills/cerebrium/SKILL.md in CerebriumAI/cerebrium-skills already reads name: cerebrium, so the docs-hosted copy had drifted. Every other channel already serves the lowercase name.

Evidence

Ran the real validator rather than reading the spec — the file as it stands on master, then the same file with this change applied:

$ npx skills-ref@latest validate ./before/cerebrium
Validation failed for ./before/cerebrium:
  - Skill name 'Cerebrium' must be lowercase
  - Directory name 'cerebrium' must match skill name 'Cerebrium'
rc=1

$ npx skills-ref@latest validate ./after/cerebrium
Valid skill: ./after/cerebrium
rc=0

Both reported errors stem from the same casing mismatch, and both clear with this one-token change.

Note for reviewers

skill.md is vendored from cerebrium-skills and is listed in .prettierignore, so it is normally not edited in this repository. This change is the exception that closes existing drift toward upstream rather than creating new drift — upstream already has the lowercase name.

Worth a separate follow-up, not addressed here: CLAUDE.md and the .prettierignore comment both describe this file as vendored "byte-for-byte", which is not strictly accurate — skill.md carries mintlify-proj: cerebrium and version: "1.0" where upstream has author and version: 0.1.0. That divergence is pre-existing and deliberately left alone here.

The Agent Skills spec requires a lowercase name, and the upstream copy in
CerebriumAI/cerebrium-skills already reads 'cerebrium'. This brings the
docs-hosted copy back in line with it.
@mintlify

mintlify Bot commented Sep 1, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cerebrium 🟢 Ready View Preview Sep 1, 2026, 2:37 PM

@jonoirwinrsa
jonoirwinrsa merged commit 13bf8ec into master Sep 1, 2026
2 checks passed
@jonoirwinrsa
jonoirwinrsa deleted the fm/gtm-docs-skill-name-lowercase branch September 1, 2026 15:33
@mintlify

mintlify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Docs PR opened: #338

Added redirects pointing three deleted pages (changelog, collaborating, Vercel integration) to the introduction; all audited page metadata already passed.

Note: failed to automatically merge

This branch was successfully deployed

1 active deployment
staging — 94abfc98 Deployed Sep 1, 2026 by mintlify[bot]
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.

3 participants