Skip to content

Commit 058cca0

Browse files
os-zhuangclaude
andauthored
fix(spec): correct skill surface comment — ask is not the open-source/free surface (#3286)
The JSDoc on SkillSchema.surface described the default `'ask'` value as "the open-source/free surface." That is inaccurate: per cloud ADR-0025 the in-product agent runtime for BOTH `ask` and `build` ships in the cloud / Enterprise distribution (the open edition is MCP-only, BYO-AI). The `surface` value is authoring metadata — which agent a skill binds to — not an edition gate. Comment-only: the Zod `.describe()` string and the schema itself are unchanged, so generated reference docs and runtime behavior are unaffected. Claude-Session: https://claude.ai/code/session_01LHQscZJ8NvXceSmsPNdTZd Co-authored-by: Claude <noreply@anthropic.com>
1 parent 447465a commit 058cca0

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

packages/spec/src/ai/skill.zod.ts

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,9 @@ export const SkillSchema = lazySchema(() => z.object({
7777
* matches either); the runtime enforces this at load time. An agent's
7878
* tool set is the union of its surface-compatible skills' tools — there
7979
* is no global fall-through (ADR-0064). Defaults to `'ask'`, the
80-
* open-source/free surface.
80+
* data-console surface. (Both the `ask` and `build` in-product agent
81+
* runtimes ship in the cloud / Enterprise distribution per ADR-0025;
82+
* the surface value here is authoring metadata, not an edition gate.)
8183
*/
8284
surface: z.enum(['ask', 'build', 'both']).default('ask').describe(
8385
"Agent surface this skill binds to ('ask' | 'build' | 'both') — ADR-0063 §3",

0 commit comments

Comments
 (0)