Skip to content

Skillscript

v0.31.1 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agents dsl llm mcp skills workflow

ReleasePort's take

Light signal
editorial:auto 12d

Release 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 summary

Fixed skill descriptions from custom SkillStores no longer appearing blank and clarified which SkillMeta fields are runtime‑derivable.

Changes in this release

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 populate SkillMeta.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 derives description from the skill's frontmatter itself — it already has the source — whenever a store returns none. Applied in both skill_preflight (detail) and buildSkillCatalog / 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 SkillMeta fields are runtime-derivable. connector-contract-reference.md gains a convention note — body-projection metadata (description, vars) the runtime derives; substrate-only metadata (author, version, timestamps, status) your impl must return. Previously only author was documented, so the description expectation 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

Track Skillscript

Get notified when new releases ship.

Sign up free

About Skillscript

All releases →

Related context

Earlier breaking changes

  • v0.35.0 Editing `# Deadline:` on an approved skill drops it to Draft (signature invalidates).

Beta — feedback welcome: [email protected]