This release includes breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
ReleasePort's take
Light signalRelease v0.31.1 of Skillscript fixes blank skill descriptions from custom SkillStores and clarifies runtime‑derivable SkillMeta fields.
Why it matters: Addresses a bug that caused skill descriptions to appear empty, improving UI reliability for developers using custom SkillStore integrations.
Summary
AI summaryFixed skill descriptions from custom SkillStores no longer appearing blank and clarified which SkillMeta fields are runtime‑derivable.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Bugfix | Medium |
Fixes blank skill descriptions on custom SkillStore. Fixes blank skill descriptions on custom SkillStore. Source: llm_adapter@2026-07-14 Confidence: low |
— |
| Refactor | Low |
Derives `description` from skill frontmatter when store returns none. Derives `description` from skill frontmatter when store returns none. Source: granite4.1:30b@2026-07-14-audit Confidence: low |
— |
| Other | Low |
Clarifies which `SkillMeta` fields are runtime-derivable in SkillStore contract docs. Clarifies which `SkillMeta` fields are runtime-derivable in SkillStore contract docs. Source: granite4.1:30b@2026-07-14-audit Confidence: low |
— |
Full changelog
Upgrade impact: none (additive). A robustness fix + doc clarification; no breaking change.
- Fix: skill descriptions no longer go blank on a custom SkillStore. The bundled stores extract
# Description:from the body and populateSkillMeta.description; a custom store that doesn't (e.g. an AMP-backed connector) left the dashboard showing a blank description in the drill-down and the wrong first-prose line (the output template) in the list. The runtime now derivesdescriptionfrom the skill's frontmatter itself — it already has the source — whenever a store returns none. Applied in bothskill_preflight(detail) andbuildSkillCatalog/skill_list(list): description precedence is store-metadata → parsed# Description:→ first-prose heuristic. Any custom SkillStore now shows correct descriptions without having to replicate the extraction. - Docs: the SkillStore contract now spells out which
SkillMetafields are runtime-derivable.connector-contract-reference.mdgains a convention note — body-projection metadata (description,vars) the runtime derives; substrate-only metadata (author,version, timestamps, status) your impl must return. Previously onlyauthorwas documented, so thedescriptionexpectation was implicit — the gap that let a connector miss it.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Skillscript
All releases →Related context
Related tools
Earlier breaking changes
- v0.35.0 Editing `# Deadline:` on an approved skill drops it to Draft (signature invalidates).
Beta — feedback welcome: [email protected]