@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 +1 -1
- package/package.json +1 -1
- package/skills/agentbuilder/SKILL.md +9 -9
package/README.md
CHANGED
package/package.json
CHANGED
|
@@ -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
|
|
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
|
|
9
|
+
"choose a model", or "fix my Standard Agents Builder app" without explicitly naming
|
|
10
10
|
Standard Agents.
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
#
|
|
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
|
|
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.
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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
|