Skip to content

feat(schema): align with Agent Skills frontmatter spec#30

Closed
t4sh wants to merge 2 commits into
mainfrom
local/agent-skills-spec-alignment
Closed

feat(schema): align with Agent Skills frontmatter spec#30
t4sh wants to merge 2 commits into
mainfrom
local/agent-skills-spec-alignment

Conversation

@t4sh

@t4sh t4sh commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add Agent Skills spec-aligned frontmatter validation for allowed-tools, license, compatibility, and metadata
  • keep legacy tools support with ambiguity warnings
  • use the package directory as the canonical skill name for drift checks and fixes
  • update README, CHANGELOG, SARIF metadata, and tests

Verification

  • npm test
  • npm run lint
  • npm run build

Merge note

Please leave this PR unmerged until CI is green. Intended landing path: manual local squash + signed push.

t4sh added 2 commits June 13, 2026 23:29
Validate the public Agent Skills frontmatter fields from https://agentskills.io/specification, including allowed-tools, name and description limits, typed license and compatibility fields, and string-valued metadata.

Prefer allowed-tools as the spec-supported field while retaining legacy tools parsing for compatibility. Also warn when linted skill files are not named SKILL.md so package layout issues are visible without breaking existing consumers.
Align name-drift with the Agent Skills package model from https://agentskills.io/specification by requiring frontmatter name: to match the parent skill directory, not an arbitrary markdown filename.

Update the safe --fix behavior to rewrite name: to the parent directory. This keeps the rule compatible with the checked erphq/skills and erpai-builder-skills layouts while matching the public specification.
@t4sh

t4sh commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

Merged manually via signed local squash commit 9b70083 pushed to main.

@t4sh t4sh closed this Jun 13, 2026
@t4sh t4sh deleted the local/agent-skills-spec-alignment branch June 13, 2026 18:03
@t4sh

t4sh commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

Reference standard used for this change: https://agentskills.io/specification

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