Align skills spec types and examples with the 2026-07-28 base schema

[sambhav]

Fixes #156.

Aligns specification/stable/skills.mdx with the 2026-07-28 base schema and records the decision.

• skills/get, resources/directory/read: named params interfaces, so _meta is required
• ReadResourceDirectoryResult extends CacheableResult (breaking: ttlMs, cacheScope required)
• *ResultResponse types for each method; optional _meta on Skill
• Request examples carry the full required _meta

Why this lands in stable

These are corrections to the published page rather than new design:

• The page doesn't compile against its own stated baseline. It says its types are those of the 2026-07-28 schema, and ReadResourceDirectoryRequest fails to type-check against it (skills.mdx: ReadResourceDirectoryRequest does not type-check against the 2026-07-28 base schema #156).
• _meta was already required. The page's text says every request MUST include it. Only the types and examples disagreed.
• Directory-read caching was missed in the 2026-09-08 pass. That decision made skills/list and skills/get cacheable so that every result type in the extension stays uniform with the base protocol; resources/directory/read was the one it didn't catch. This is the only change that adds a requirement on servers, and it affects an optional method behind directoryRead: true.

Corrections like these have landed on stable in place before (#139, and #147 after SEP-2640 went Final), so I've followed that route rather than opening a draft/ revision. index.md excerpt ranges are re-anchored to the new line numbers.

Verification

All interfaces and all 16 examples type-check under --strict against the base schema; docs:build passes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01M8b7Vuu2jRefMhoZB3BrrX

---

Generated by Claude Code

[cloudflare-workers-and-pages]

Deploying ext-skills with    Cloudflare Pages

Latest commit:	87cd708
Status:	✅  Deploy successful!
Preview URL:	https://d7f1f8d1.ext-skills.pages.dev
Branch Preview URL:	https://fix-156-request-params-types.ext-skills.pages.dev

View logs

[Copilot]

🟢 Approval recommended

The proposal correctly follows repository governance and resolves the reported type inconsistencies.

0 open findings

What changed in this PR

Proposes a type-safe correction to the next Skills specification revision.

Changes:

• Adds named request-parameter interfaces requiring _meta.
• Aligns request inheritance with the base schema.
• Updates the referenced base-type list.

File	Description
docs/​decisions.md	Records the proposed schema-rendering correction and rationale.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

🟡 Changes recommended

The draft page’s edit link incorrectly targets the stable specification.

1 open finding

• Point draft page edit link to draft MDX · New

🧠 Review effort: Balanced

[Copilot]

🔵 Needs a closer look

The draft page’s edit link incorrectly targets the released stable specification.

1 open finding

• Point draft page edit link to draft MDX

🧠 Review effort: Balanced

[Copilot]

🟡 Changes recommended

It applies a breaking Proposed decision directly to the stable specification, contrary to the repository’s release process.

3 open findings

• Do not apply proposed breaking changes to stable specification · New
• Remove stale Result and Cursor references · New
• Point draft page edit link to draft MDX

🧠 Review effort: Balanced

[Copilot]

🔵 Needs a closer look

Making directory-read caching fields mandatory is a breaking normative change requiring final human confirmation.

0 open findings

3 resolved since last review

• Do not apply proposed breaking changes to stable specification
• Remove stale Result and Cursor references
• Point draft page edit link to draft MDX

🧠 Review effort: Balanced