Skip to content

chore(skills): version frontmatter + examples pointers#4

Merged
hopeatina merged 1 commit into
mainfrom
feat/skill-md-versioning-and-golden-examples
Apr 17, 2026
Merged

chore(skills): version frontmatter + examples pointers#4
hopeatina merged 1 commit into
mainfrom
feat/skill-md-versioning-and-golden-examples

Conversation

@hopeatina
Copy link
Copy Markdown
Contributor

Summary

  • Every SKILL.md now carries a `version:` field mirroring its `skill.toml` version. skillDiscovery.ts in the main OrgX app expected this but never got it populated.
  • Each agent skill's `examples/` folder is now surfaced inline from the SKILL.md body — the worked examples already existed on disk but were invisible to anyone reading SKILL.md directly.

Why

Main app's Phase 2 substrate benchmark (`runtime-phase-2-matrix.mjs`, stacked PR #661) now loads SKILL.md + examples/*.md as the system prompt for `orgx_full` cells instead of the 8-line `ORGX_SKILL_PROMPT` shim it used in Phase 1. This PR makes that loader deterministic and hash-pinnable.

Versions

  • `nightly-recap`: 1.0.0
  • all 14 others: 2.0.0 (matches skill.toml)

Test plan

  • 15/15 SKILL.md files have `version:` in frontmatter
  • 4 agent skills (product, engineering, marketing, operations) reference their `examples/` folders inline
  • `python3 scripts/check_skill_tool_drift.py` still passes

🤖 Generated with Claude Code

Every SKILL.md now carries a `version:` field mirroring its skill.toml
version so consumers can hash-pin loaded content. This was expected by
skillDiscovery.ts in the main OrgX app but never populated.

Also surfaces each agent skill's `examples/` folder inline — the worked
examples already existed on disk but were invisible from SKILL.md itself.
Phase 2 benchmark now loads SKILL.md + examples/*.md together as the
system prompt for orgx_full cells.

Versions:
- nightly-recap: 1.0.0
- all others: 2.0.0 (matches skill.toml)
@hopeatina hopeatina merged commit c1a0edb into main Apr 17, 2026
1 check passed
@hopeatina hopeatina deleted the feat/skill-md-versioning-and-golden-examples branch April 17, 2026 10:34
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