Skip to content

docs(skills): cite the platform-tool registry instead of restating it #17259

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-zhuang merged 1 commit into from
Sep 10, 2026
Merged

docs(skills): cite the platform-tool registry instead of restating it #17259

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 7 additions & 8 deletions skills/objectstack-ai/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,17 +68,16 @@ conditions.
### Naming the tools: the resolution ladder

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

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