@standardagents/skill 0.45.2 → 0.45.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @standardagents/skill
2
2
 
3
- Markdown-authored coding skills for Standard Agents and AgentBuilder.
3
+ Markdown-authored coding skills for Standard Agents Builder.
4
4
 
5
5
  ## Overview
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@standardagents/skill",
3
- "version": "0.45.2",
3
+ "version": "0.45.3",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public",
@@ -2,15 +2,15 @@
2
2
  name: agentbuilder
3
3
  description: >
4
4
  Use this skill when creating, editing, debugging, reviewing, or documenting
5
- Standard Agents or AgentBuilder projects. Apply it for work on agents,
5
+ Standard Agents Builder projects. Apply it for work on agents,
6
6
  prompts, models, tools, hooks, threads, APIs, subagents, provider setup,
7
7
  model selection, environment variables, and spec-aligned architecture, even
8
8
  if the user only says things like "build an agent", "write a prompt",
9
- "choose a model", or "fix my AgentBuilder app" without explicitly naming
9
+ "choose a model", or "fix my Standard Agents Builder app" without explicitly naming
10
10
  Standard Agents.
11
11
  ---
12
12
 
13
- # AgentBuilder Skill
13
+ # Standard Agents Builder Skill
14
14
 
15
15
  This guide is a living record. It is not part of the Standard Agent Specification — it exists to help humans and coding agents *use* the spec to build effective agents. It is updated regularly and not bound to any spec version.
16
16
 
@@ -32,7 +32,7 @@ For deeper reference material that this skill links to, see:
32
32
 
33
33
  ## The specification comes first
34
34
 
35
- This skill covers how to build with AgentBuilder. The published Standard Agent Specification defines what a Standard Agent is. Read it before you answer what the specification requires, decide whether an agent is portable, or write or review a definition that must conform. Do not answer from memory, and do not rely on a remembered version number.
35
+ This skill covers how to build with Standard Agents Builder. The published Standard Agent Specification defines what a Standard Agent is. Read it before you answer what the specification requires, decide whether an agent is portable, or write or review a definition that must conform. Do not answer from memory, and do not rely on a remembered version number.
36
36
 
37
37
  1. Read https://standardagentspec.org/llms.txt. Its `Latest version:` line names the latest version, and it lists a Markdown URL for every page of that version.
38
38
  2. Use the latest version unless the user or the project names another one. For a named older version, read `https://standardagentspec.org/api/navigation/<version>.json`. Each `href` in it becomes a Markdown URL when you put `https://standardagentspec.org` before it and `.md` after it.
@@ -40,7 +40,7 @@ This skill covers how to build with AgentBuilder. The published Standard Agent S
40
40
  4. Name the version and the pages you used in your answer. Separate what the specification requires from what it recommends and from your own inference. When the specification does not define something, say so.
41
41
  5. If you cannot reach the site, tell the user, and label anything you then say about the specification as unverified.
42
42
 
43
- If this skill and the published specification disagree, the specification is correct. Report the disagreement to the user. AgentBuilder's types, source, and documentation, and this skill, describe AgentBuilder only.
43
+ If this skill and the published specification disagree, the specification is correct. Report the disagreement to the user. Standard Agents Builder's types, source, and documentation, and this skill, describe Standard Agents Builder only.
44
44
 
45
45
  ## Keeping this skill up to date
46
46
 
@@ -67,7 +67,7 @@ Most failed Standard Agent projects fail in the same seven ways. Read this secti
67
67
  List the domains the system touches. Determine the tree (coordinator → domain agents → sub-domain agents). *Then* decide what each node is. Do not start by writing one agent and bolting tools onto it. → [Architecture & decomposition](#architecture--decomposition)
68
68
 
69
69
  **2. Decide what backs each side. Prompt × prompt is the default worker shape; a human backing is the exception.**
70
- Every agent has exactly two explicit sides, and each side is backed by exactly one of a human, a prompt, or a handler. A human backing is correct only when the thread itself is the chat surface (chat UI, website widget, AgentBuilder admin, direct API chat). For Slack, email, SMS, Discord, webhooks, polled inboxes, schedulers, or any other mediated channel, the human is just a tool target — back both sides with prompts. The whole graph being prompt × prompt is fine and often cleaner. → [What backs each side?](#what-backs-each-side)
70
+ Every agent has exactly two explicit sides, and each side is backed by exactly one of a human, a prompt, or a handler. A human backing is correct only when the thread itself is the chat surface (chat UI, website widget, Standard Agents Builder admin, direct API chat). For Slack, email, SMS, Discord, webhooks, polled inboxes, schedulers, or any other mediated channel, the human is just a tool target — back both sides with prompts. The whole graph being prompt × prompt is fine and often cleaner. → [What backs each side?](#what-backs-each-side)
71
71
 
72
72
  **3. Every prompt × prompt agent must have explicit session boundaries.**
73
73
  Name its `sessionStop` tool. Name its `sessionFail` tool. Set a finite `maxSessionTurns` (the spec makes the cap optional; this skill makes it required practice for prompt × prompt). Give side B a real, non-redundant job. If you cannot say in one sentence what tool call ends the session, the agent is not designed yet. → [Session boundary discipline](#session-boundary-discipline)
@@ -208,7 +208,7 @@ Every agent has **exactly two sides** — `sideA` and `sideB` — and each side
208
208
 
209
209
  There is no agent `type` field. Chat surface, composability, and termination are all **derived from the backings**. Both sides are always explicit — if a person takes side B's turns, write `sideB: { human: true }`; there is no implicit default side.
210
210
 
211
- > **Prompt × prompt is the default worker shape. A human backing is the exception**, used only when the thread itself is the chat surface — chat UI, website widget, AgentBuilder admin, or an API the user is talking to directly.
211
+ > **Prompt × prompt is the default worker shape. A human backing is the exception**, used only when the thread itself is the chat surface — chat UI, website widget, Standard Agents Builder admin, or an API the user is talking to directly.
212
212
 
213
213
  For **Slack, email, SMS, Discord, webhooks, polled inboxes, schedulers, or any other mediated channel**, the human is just a tool target. Back both sides with prompts. The whole graph being prompt × prompt is fine — often cleaner.
214
214
 
@@ -571,7 +571,7 @@ probabilities, confidence, and score legends; boolean answers return a 0–1
571
571
  request/response/duration/status/cost automatically, persist before the first
572
572
  message, and never append messages;
573
573
  explicitly use `state.injectMessage()` when needed.
574
- Automatic logging and optional `name`/`trigger` attribution are AgentBuilder
574
+ Automatic logging and optional `name`/`trigger` attribution are Standard Agents Builder
575
575
  extensions, not spec requirements. Standalone `typesafe({ apiKey }).decide(...)`
576
576
  creates no thread logs. Read the package README for limits and the complete
577
577
  conversion contract.
@@ -1206,7 +1206,7 @@ Validation order:
1206
1206
  2. Refresh Cloudflare types:
1207
1207
  - use `pnpm cf-typegen` if that script exists
1208
1208
  - otherwise run `npx wrangler types`
1209
- 3. Regenerate AgentBuilder types by running the project's build command:
1209
+ 3. Regenerate Standard Agents Builder types by running the project's build command:
1210
1210
  - usually `pnpm build`, `npm run build`, `pnpm run dev`, or equivalent
1211
1211
  4. Run the project's type checker:
1212
1212
  - prefer `pnpm type-check` / `npm run type-check` if present