Skip to content

Skillscript

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

Affected surfaces

auth

Summary

AI summary

Allowlist denial messages now instruct agents to escalate rather than self‑edit.

Full changelog

Upgrade impact: none (additive)

  • Allowlist denial messages now tell agents to escalate, not self-edit. When a skill hits an off-allowlist shell binary or filesystem path, the runtime's remediation (ShellBinaryNotAllowedError, FilePathNotAllowedError) and the shell-binary-not-allowed lint rule previously read as an operator runbook — "add it to SKILLSCRIPT_SHELL_ALLOWLIST in your .env, then restart." Returned to a connecting agent through the MCP error, that reads as an instruction: the agent edits .env to self-grant the capability, defeating the operator boundary. The messages now lead with an agent-facing "stop — this is a human-operator boundary; ask the operator, don't edit config yourself," with the wiring how-to clearly labeled operator-only (and a pointer to blocked_shell_attempts as the operator's review surface). Allowlist enforcement itself is unchanged.
  • CLI reference accuracy. The README + landing-page CLI table dropped three commands removed back in v0.2.1 (register-trigger / unregister-trigger / list-triggers) and a dead run alias, added init / list / approve / reapprove, and now mirrors the CLI's own command order.
  • Quickstart restructured around the human/agent division of labor — the human installs, configures, and wires the MCP; the human and agent author the first skill together — and the dashboard step is corrected (it's a blocking foreground server, so the browser is opened separately).
  • .env.example trimmed to what each setting does (the security rationale moved to the adopter playbook), and its example port corrected to 7878.

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]