Agent Skills' spec workflow now stops and waits for your approval before planning

1 month ago

Agent Skills 0.6.12 (October 3, 2026) makes the spec-driven-development skill end its turn after saving the spec and wait for your approval, a fix for hosts like Codex that load the skill without the /spec command. Also: an invented Prisma rollback command removed, a code sample that now parses, a slimmer performance-optimization skill, and a mutation check in code review. Release notes: https://github.com/addyosmani/agent-skills/releases/tag/0.6.12 Spec fix: https://github.com/addyosmani/agent-skills/pull/629 Issue: https://github.com/addyosmani/agent-skills/issues/622

Ask about this presentation

Chapters

  1. 0:00Agent Skills' spec workflow now stops and waits for your approval before planning
  2. 0:12On Codex, one model ran spec, plan, tasks and code in a single turn
  3. 0:25The pause lived in the /spec command, which Codex never loads
  4. 0:39The skill now tells the agent to stop its turn after the spec
  5. 0:52Claude Opus and Haiku already stopped, so the fix is unmeasured there
  6. 1:04The stop covers the spec phase only
  7. 1:15The launch checklist no longer tells you to run a Prisma command that doesn't exist
  8. 1:29The idempotency example now parses as JavaScript
  9. 1:41performance-optimization now loads at 267 lines instead of 496
  10. 1:57Code review now checks the tests by breaking one condition
  11. 2:12Setup guides for Oh My Pi and Dojo Workspace shipped, then were withdrawn
  12. 2:30Close
Show transcript
  1. Addy Osmani's Agent Skills changed its spec-driven-development skill on October 3rd. Once the spec is saved, the skill now ends its turn and waits for your approval before any planning starts.

    Slide text
    github.com/addyosmani/agent-skills Oct 3, 2026
    Specify
    STOP · you approve
    Plan Tasks Implement
    spec-driven-development · PR #629, merged Oct 3, 2026
  2. A Codex user running a DeepSeek model asked for a spec to review. Instead the skill ran straight through planning, tasks and implementation in one turn. It wrote code before the user could review the spec.

    Slide text
    issue #622 Oct 3, 2026
    Specify → Plan → Tasks → Implement
    all in one turn

    “I need to perform a manual review after the spec document is generated”

    issue #622, opened Sep 30, 2026 · PR #629
  3. The instruction, confirm with the user before proceeding, lived only in the /spec command for Claude Code. Codex loads just the skill, which said to validate each phase but not who validates, or that the agent should wait.

    Slide text
    .claude/commands/spec.md · SKILL.md Oct 3, 2026
    /spec command · Claude Code
    “…confirm with the user before proceeding.”
    the skill itself, before
    “Do not advance to the next phase until the current one is validated”
    says nothing about who validates, or that the agent waits
    PR #629 · issue #622
  4. Now the skill itself carries the gate. The agent summarizes the spec, lists open questions, and asks for approval. Then it stops its turn. Planning starts only after you approve, in a later turn.

    Slide text
    skills/spec-driven-development/SKILL.md Oct 3, 2026
    + Stop after writing the spec (CRITICAL). Once the spec is saved:
    + 1. Summarize it and list any Open Questions.
    + 2. Ask the human to approve it or request changes.
    + 3. STOP YOUR TURN IMMEDIATELY. Do NOT start Phase 2, invoke planning-and-task-breakdown, or write code in this turn.
    PR #629 · fixes issue #622
  5. The author tested Claude Opus and Haiku, and both already stopped after the spec, with or without the change. So the run-through wasn't reproduced on Claude, and the fix is unmeasured there.

    Slide text
    PR #629 · Verification Oct 3, 2026
    before the fix
    stops
    Opus and Haiku, end-to-end prompt
    after the fix
    stops
    same prompt, same models

    The run-through was not reproduced with Claude models.

    PR #629, author's verification notes
  6. The change covers the spec phase and nothing past it. The author says the capability map that comes before it, and the /build command, have similar gaps, and left both out of this fix.

    Slide text
    PR #629 · scope Oct 3, 2026
    Spec phase stop rule added
    Capability map similar gap, left out
    /build command similar gap, left out
    PR #629
  7. The shipping-and-launch skill's rollback plan told you to run a Prisma migrate rollback command, and Prisma has no such command. The template now asks for your project's verified rollback command or runbook, whatever migration tool you use.

    Slide text
    skills/shipping-and-launch/SKILL.md · rollback plan Oct 3, 2026
    - Migration [X] has a rollback: npx prisma migrate rollback
    + Migration [X] has a rollback: <verified command or runbook link>
    PR #628, merged Oct 3, 2026
  8. In the api-and-interface-design skill, the idempotency example ended its catch block with a bare throw, which is a syntax error in JavaScript. It now rethrows the caught error.

    Slide text
    skills/api-and-interface-design/SKILL.md Oct 3, 2026
    } catch (e) {
    if (isUniqueViolation(e)) return replayOrReject(key);
    - throw;
    + throw e;
    }
    PR #627, merged Oct 3, 2026
  9. The performance-optimization skill got shorter. It went from almost 500 lines to about 270, roughly a quarter fewer tokens each time it loads. The worked code fixes moved into a reference file the agent opens when it needs one.

    Slide text
    skills/performance-optimization/SKILL.md Oct 3, 2026
    before 496 lines
    now 267 lines

    Worked fixes moved to references/optimization-patterns.md

    PR #580, merged Oct 3, 2026
  10. The code-review-and-quality skill asked whether the tests would catch a regression, without saying how to find out. Now it tells the reviewer to invert one condition the change adds and run the suite. If the suite stays green, that's a missing test.

    Slide text
    skills/code-review-and-quality/SKILL.md Oct 3, 2026
    Would the tests catch a regression if the code changed?
    + Invert one condition the change adds, run the suite, then restore the file.
    + A mutation that stays green is a finding: name the missing test case.
    PR #618, merged Oct 2, 2026
  11. The release shipped setup guides for Oh My Pi and Dojo Workspace. Both were withdrawn on the main branch that day, because the maintainers hadn't run either host. The contributor guide now says the readme lists only hosts a maintainer has run, and the hosts already there will be checked against that.

    Slide text
    PR #641 · CONTRIBUTING.md Oct 3, 2026
    Oh My Pi guide withdrawn · now one line in other hosts
    Dojo Workspace guide withdrawn

    New rule in CONTRIBUTING: the README lists only hosts a maintainer has run.

    PR #641, merged Oct 3, 2026 · release notes
  12. The spec stop is written for models that skip an implied gate. Claude Opus and Haiku already stopped. Agent Skills' spec workflow now stops and waits for your approval before planning. The notes are on the project's GitHub releases page.

    Slide text
    github.com/addyosmani/agent-skills/releases Oct 3, 2026

    The spec stop is written for models that skip an implied gate. On Claude Opus and Haiku it was already the behavior.

    Agent Skills' spec workflow now stops and waits for your approval before planning

    Specify
    STOP · you approve
    Plan Tasks Implement
    addyosmani/agent-skills · release notes, Oct 3, 2026

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built with ❤️ in New York