Skip to content

Commit a256f18

Browse files
os-justinclaude
andauthored
docs(skills): cite the platform-tool registry instead of restating it (#17259)
The resolution-ladder passage in `skills/objectstack-ai/SKILL.md` carried three tool counts and two source line ranges. Counts and ranges are copies of the registry, so every registry change owed this passage a correction that nobody made: the `validate-ai-tool-references.ts` range was already wrong before the registry grew, and the counts went stale on the merge that added tools. Cite by symbol instead. `collectToolUniverse` names the resolver and `PLATFORM_TOOLS_BY_PACKAGE` names the registry, both without ranges; the per-package character of each group stays (structure, not counts) and the passage keeps telling the reader to open the file for the exact set. Nothing in the tree read the removed numbers, so no gate or generator follows. Claude-Session: https://claude.ai/code/session_01MoTv7pn338AZ71owsp19gQ Co-authored-by: Claude <noreply@anthropic.com>
1 parent ebf9a48 commit a256f18

1 file changed

Lines changed: 7 additions & 8 deletions

File tree

‎skills/objectstack-ai/SKILL.md‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -68,17 +68,16 @@ conditions.
6868
### Naming the tools: the resolution ladder
6969

7070
A `skill.tools[]` entry resolves against the union of three sources
71-
(`packages/lint/src/validate-ai-tool-references.ts:148-171`):
71+
(`collectToolUniverse` in `packages/lint/src/validate-ai-tool-references.ts`):
7272

7373
1. **`stack.tools[].name`** — records your own stack declares. ADR-0109: the
7474
default third-party path declares **none** (see *Tool metadata* below).
75-
2. **`PLATFORM_PROVIDED_TOOL_NAMES`** — the 30 statically-registered platform
76-
tools, grouped by owning package in
77-
`packages/spec/src/system/constants/platform-tool-names.ts:38-82` — 6 data /
78-
knowledge tools from `service-ai` (`query_records`, `get_record`,
79-
`query_data`, `aggregate_data`, `search_knowledge`, `visualize_data`) and 24
80-
schema / metadata / package tools from `service-ai-studio`. Read that file for
81-
the exact set: it is the registry the lint rule checks against.
75+
2. **`PLATFORM_PROVIDED_TOOL_NAMES`** — the statically-registered platform
76+
tools, flattened from `PLATFORM_TOOLS_BY_PACKAGE` in
77+
`packages/spec/src/system/constants/platform-tool-names.ts`: data /
78+
knowledge tools from `service-ai`, schema / metadata / package tools from
79+
`service-ai-studio`. Read that file for the exact set: it is the registry
80+
the lint rule checks against.
8281
3. **`action_<name>`** — one tool per AI-exposed Action of your own stack
8382
(`PLATFORM_TOOL_FAMILY_PREFIXES`). **The default path** for anything your app
8483
does.

0 commit comments

Comments
 (0)