Skip to content

docs(skills): settle two false claims in skills/README.md and add three cross-skill routing bullets #14795

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 3, 2026
+7 −2
Merged

docs(skills): settle two false claims in skills/README.md and add three cross-skill routing bullets #14795

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
9 changes: 7 additions & 2 deletions skills/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,8 @@ carries `SKILL.md` alone — `gen:skill-refs` only visits skills listed in its
- **Short object names** (`account`, `task`); no `namespace`, no `tableName`.
- **CEL for all expressions** — predicates, conditions, schedules. Use the
`F\`\``, `P\`\``, `cel\`\``, `cron\`\``, `tmpl\`\`` tagged templates from
`@objectstack/spec`. Legacy `OLD` / `NEW` evaluate to `null` since M9.5.
`@objectstack/spec`. Legacy `OLD` / `NEW` are not CEL — use
`previous.` / `record.`.
- **v5.0 vocabulary** — runtime workspace is `environment`, not `project`.
- **Singular metadata type names** (`agent`, `view`, `flow`, …); REST resource
collections are plural (`/api/v1/ai/agents`).
Expand All @@ -102,10 +103,14 @@ A few common decision points where the right skill isn't obvious:
**automation** (screen flows). Static record / list / dashboard surfaces are
**ui**.
- **Any CEL expression** — load **objectstack-formula** alongside the host
skill (data validations, automation guards, UI visibility, AI tool params).
skill (data validations, automation guards, UI visibility).
- **Kernel / plugin events vs. data lifecycle** — `PluginContext` lifecycle and
`EventBus` belong to **objectstack-platform**; record-level hooks belong to
**objectstack-data**.
- **Labels vs. bundles** — a `label` you want translated is **objectstack-i18n**.
- **Upgrade vs. platform** — a protocol-major move is **objectstack-upgrade**.
- **Rendering this metadata** — the consuming UI is
[objectui `skills/objectui/`](https://github.com/objectstack-ai/objectui).

---

Expand Down
Loading