Skip to content

Skillscript

v0.19.13 Breaking

This release includes 2 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

Removed undocumented frontmatter headers # Connectors: and # Use when:.

Full changelog

Removed (pre-v1.0 surface freeze cleanup)

Two frontmatter headers that shipped as discipline-only-contract
surfaces with no enforcement or downstream consumers — removed
to keep the v1.0 frozen surface honest.

  • # Connectors: — documented in language-ref atoms but never
    parsed, linted, or read anywhere in the runtime. Doc surface
    claimed per-skill connector selection; implementation had zero
    lines of code matching the claim. Removed from doc atoms; no
    code change needed since nothing referenced the header.
  • # Use when: — inverse rot: parsed and stored on the AST
    (ParsedSkill.useWhen) but with zero downstream readers (no
    skill_list surface, no lint, no dashboard render). Parser hook
    and AST field removed; existing skills using the header (if any)
    now silently ignore the line, same as any unrecognized
    # Foo: key.

Both were the same shape — surfaces named without wiring — and
the v1.0 surface-freeze commit means every documented header must
be backed by actual behavior. Pre-v1.0 + zero adopter usage =
clean removal, no migration tooling needed.

Documented — agent_id 2-level resolution chain

# Output: agent: <target> and # Output: template: <target>
have always resolved through a 2-level chain (explicit literal

  • compile-time ${VAR} substitution against the resolved inputs
    map), but the spec lived only in language-ref atoms — no MD
    documentation, no help() topic coverage. Skill authors writing
    # Output: agent: ${TEAM} had to discover the behavior by
    trial-and-error or by reading compile.ts.

Now documented in:

  • docs/language-reference.md — new "Output target resolution"
    subsection in the output section (right after Multiple output
    targets).
  • src/help-content.ts — new "Output target resolution"
    subsection in the help(topic: "frontmatter") reference.

No code change; pure documentation completion of the existing
v0.19.12 surface ahead of the v1.0 freeze.

Breaking Changes

  • Removed frontmatter header `# Connectors:` — no longer accepted or parsed.
  • Removed frontmatter header `# Use when:` — no longer stored on the AST.

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]