Skip to content

Comments

feat(zeph-skills): align SKILL.md parser with agentskills.io spec#690

Merged
bug-ops merged 1 commit intomainfrom
feat/686-skill-spec-conformance
Feb 21, 2026
Merged

feat(zeph-skills): align SKILL.md parser with agentskills.io spec#690
bug-ops merged 1 commit intomainfrom
feat/686-skill-spec-conformance

Conversation

@bug-ops
Copy link
Owner

@bug-ops bug-ops commented Feb 21, 2026

Summary

Aligns the SKILL.md frontmatter parser (crates/zeph-skills/src/loader.rs) with the Agent Skills specification.

  • allowed-tools field now uses space-separated values per spec (was comma-separated)
  • Nested metadata: block parsing with indentation-aware key-value extraction
  • description capped at 1024 chars, compatibility capped at 500 chars per spec
  • Body size warning when SKILL.md body exceeds 20KB (~5000 tokens recommended)
  • compatibility/license empty values normalized to None
  • 13 new tests, 1 updated test

Closes #686

Breaking changes

  • allowed-tools delimiter changed from comma to space. Existing skills using commas need updating.

Test plan

  • cargo nextest run -p zeph-skills — 56 tests pass
  • cargo nextest run --workspace --lib --bins — 2227 tests pass
  • cargo clippy --workspace -- -D warnings — clean
  • cargo +nightly fmt --check — clean

Follow-up issues

- allowed-tools field now uses space-separated values (was comma-separated)
- nested metadata: block parsing with indentation-aware key-value extraction
- description capped at 1024 chars, compatibility capped at 500 chars
- tracing::warn! in load_skill_body() when body exceeds 20000 bytes
- compatibility/license empty values now produce None instead of Some("")
@github-actions github-actions bot added documentation Improvements or additions to documentation skills SKILL.md system rust enhancement New feature or request size/M labels Feb 21, 2026
@bug-ops bug-ops enabled auto-merge (squash) February 21, 2026 00:14
@bug-ops bug-ops merged commit b9facc4 into main Feb 21, 2026
25 checks passed
@bug-ops bug-ops deleted the feat/686-skill-spec-conformance branch February 21, 2026 00:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request rust size/M skills SKILL.md system

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Align SKILL.md parser with agentskills.io specification

1 participant