Skip to content

Commit a6e0010

Browse files
os-zhuangclaude
andauthored
docs(skills): drop the dead target key from the objectstack-api object_operation example (#11291) (#11748)
`ApiEndpoint.target` became optional in #10338 (landed as #11290): it is required at publish only for `type: 'flow'` and is UNREAD for `type: 'object_operation'`, which is addressed by `objectParams.object` / `.operation`. Nothing checks a `target` written beside them against `objectParams.object`, so the `leadFeed` example was teaching a dead string — the exact AI-authoring trap #10338 removed. The in-tree examples and the protocol/getting-started docs were swept in #11290; the published skill was out of that card's file surface. The example now omits the key. No explanatory note was added: the published skills token ratchet had zero headroom on this file (ceiling 6348, file 6348), and the card made that note conditional on budget. The gate-description lines (~212-214) already state the per-type rule ("an `object_operation` needs both `objectParams` halves; a `flow` needs a `target`") and stay unchanged. Lower the file's ratchet ceiling 6348 -> 6342 to lock in the saving, per the ratchet's own documented discipline ("a ceiling may be LOWERED by any PR that shrinks its file ... always legitimate and encouraged"). Claude-Session: https://claude.ai/code/session_5213b871-5164-5bc3-8874-28b336bbcd40 Co-authored-by: Claude <noreply@anthropic.com>
1 parent f6e182d commit a6e0010

2 files changed

Lines changed: 1 addition & 2 deletions

File tree

scripts/check-skills-token-ratchet.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ export const CEILING_BASIS = {
142142
*/
143143
export const CEILINGS = new Map([
144144
['skills/objectstack-ai/SKILL.md', 6824],
145-
['skills/objectstack-api/SKILL.md', 6348],
145+
['skills/objectstack-api/SKILL.md', 6342],
146146
['skills/objectstack-automation/SKILL.md', 12543],
147147
// basis 7228d6c25 (PR #10402 head), not main — see CEILING_BASIS.
148148
// +20 (13797→13817): maintainer ruling 2026-08-23 on PR #11141 — the three

skills/objectstack-api/SKILL.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -178,7 +178,6 @@ export const leadFeed: ApiEndpoint = {
178178
method: 'GET',
179179
summary: 'Lead feed',
180180
type: 'object_operation',
181-
target: 'acme_lead',
182181
objectParams: { object: 'acme_lead', operation: 'find' },
183182
// `authRequired` omitted → defaults to `true`. Omission is SAFE.
184183
cacheTtl: 30, // seconds; GET-only; success answers only

0 commit comments

Comments
 (0)