Skip to content

Skillscript

v0.27.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

Summary

AI summary

Fixed four TypeScript example files that failed to compile due to contract drift.

Changes in this release

Bugfix Medium

Four example TypeScript files now compile against connector contracts.

Four example TypeScript files now compile against connector contracts.

Source: llm_adapter@2026-07-16

Confidence: high

Bugfix Medium

`morning-brief` skill example corrected to use per-leg `(fallback:)` pattern and render fallback output.

`morning-brief` skill example corrected to use per-leg `(fallback:)` pattern and render fallback output.

Source: llm_adapter@2026-07-16

Confidence: high

Bugfix Medium

Default recursion depth for `help({topic:"composition"})` corrected from "depth-5" to runtime's 10.

Default recursion depth for `help({topic:"composition"})` corrected from "depth-5" to runtime's 10.

Source: llm_adapter@2026-07-16

Confidence: high

Bugfix Medium

New test suite `tests/examples-corpus.test.ts` ensures all bundled skills compile, execute end‑to‑end, and typecheck against current contracts.

New test suite `tests/examples-corpus.test.ts` ensures all bundled skills compile, execute end‑to‑end, and typecheck against current contracts.

Source: llm_adapter@2026-07-16

Confidence: low

Full changelog

Upgrade impact: none (additive). Example + help-content fixes; no runtime behavior change.

A pre-announcement review ran every shipped example against the current runtime and contracts. Findings, all fixed:

  • Four example TypeScript files had drifted off the connector contracts and no longer compiled — the fork-me DataStoreTemplate and the onboarding scaffold's file-data-store were missing the v0.13.8 DataStore.get(); file-data-store / openai-local-model / tmux-shell-agent-connector used stale feature-flag keys outside the closed per-kind unions; the tmux connector was missing WakeReceipt.woken plus the health_check() / request_response() contract methods. Nothing compiled the example .ts files, so the drift was silent — the worst first-copy experience for an adopter forking a template.
  • morning-brief declared # OnError: morning-brief-degraded — a skill that doesn't ship (dangling reference, so the example didn't compile standalone) and a mechanism that isn't wired in the runtime. Rewritten to the v0.27.0 pattern it should be teaching: a per-leg (fallback:) on every gather leg + a fallback-bound BRIEF so the output template always renders, degrading loudly per source.
  • New tests/examples-corpus.test.ts locks all of this in: every bundled skill compiles (with declared inputs), the infra-free skills execute end-to-end against the bundled bootstrap, the programmatic trace demo runs, and every example .ts typechecks against the current contracts — the fork-template-drift guard that was missing.
  • help({topic:"composition"}) recursion default corrected — said "depth-5"; the runtime's DEFAULT_MAX_RECURSION_DEPTH is 10.
  • Docs pass (pre-announcement). language-reference.md re-rendered from the canonical atoms (v0.27.0 uniform (fallback:) semantics; # OnError: flagged parsed-but-not-wired throughout). adopter-playbook.md: the retired ??/ask() mutation-authorization path removed (three mentions; retired in v0.16.0) and the (fallback:) trailer section updated to the uniform op list. configuration.md: SKILLSCRIPT_SECRET_<NAME> added to the env-var reference (the one runtime env var missing from the table). adopter-agent-guide.md: help topic lists updated to the current 7-topic set (incl. error-handling). index.md: examples bullet no longer advertises the unwired # OnError:. ARCHITECTURE.md re-synced to shipped reality (LOC ceiling, file inventory incl. secrets.ts, canonical parser grammar, ~77 lint rules, delete CLI command, v0.27.0 runtime row) and its AMP doc atoms updated to match.

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]