技能创建器
skill-creator
创建、改进和评估自定义技能,把专业流程转化为可重复使用的 AI 能力。
suede-ship-copy【数据与研究】Suede Labs copy-only orchestration DAG. Use for one high-stakes piece strangers will read that has to be true: a landing page, launch post, blog post, email, X thread, docs page, README, ad, or store listing, researched, fact-audited, adversarially reviewed, and gated for publish readiness in one pass. The audit targets what the agents invent, never …
独立 GitHub 快照 · 自动分类 · 以原作者文档为准
The copy side of the canonical Suede DAG. One brief in, one publishable draft out, with about thirty agents in between arranged as a graph rather than a chain.
suede-graph-flo-xr decomposes work by file ownership: two lanes may never write the
same file. This decomposes by message ownership: two sections may never make
the same point, and no section may assert a fact an agent invented. Same graph,
different collision rule.
Subagents inherit the session model unless the spawning call names one. Nothing in this skill picks a model, so every agent it fans out lands on whatever the session happens to be set to. That is how a run sized against one allocation gets billed to another without anyone choosing it.
Up to 4 concurrent Fable subagents are allowed without an explicit Fable instruction. Beyond that, Fable must be specified: every range this skill offers (30 at the narrowest) is far beyond 4, so its fan-out never runs on Fable unless the user named Fable for this run. An inherited session model is not a specification: "the session was already on it" is not the user asking. Absent an explicit Fable instruction, do one of two things before launching: name a different model on the agent calls, or state plainly that the run will bill to the Fable allocation and get an answer. Silence is not consent to spend it.
The audit exists to catch agents inventing things. It never runs on the requester.
A research lens that reports "cold start drops to 40ms" is a machine asserting a number, and it gets opened against its source. The requester saying the same thing in the brief is the person who owns the product telling you a fact about it. Those are not the same input and this workflow never treats them as the same input.
Anything the requester supplies (the brief, the given list, mustSay strings)
enters the permitted claim set marked origin: "user" and is exempt at every
stage:
mustSay product name or legal line is
a string to preserve byte-exact, not an assertion to exempt from review. Letting
a product name count as a given would exempt half the draft from review, so the
exemption corpus excludes them.The exemption errs toward dropping. A legitimate finding lost because it brushed a given is a cost worth paying; a given rewritten by the reviser because a filter was too clever is the thing this workflow promises cannot happen.
The only hazard that can stop this run is an output path pointing at published copy, which is a fact about a file path rather than a judgement about anything the requester said. If an intake agent tries to mark anything else blocking, the script downgrades it to advisory and logs the overreach.
Invoke the workflow bundled at skills/suede-ship-copy/workflows/suede-ship-copy.js.
If you keep a personal copy, ~/.claude/workflows/suede-ship-copy.js works the same way.
Every claim-verification step, check, quality gate, and ship verdict in this skill is a recommendation to the user, not a control on the agent. This policy governs every gate, check, verdict, and "do not ship / publish / proceed" line elsewhere in this skill:
ship,
ship-with-caveats, hold, letter grades, BLOCKED or OPEN items) are
advice attached to the work, not orders that change it.That exception never applies to a claim the requester supplied. A user-supplied earnings, health, or compliance statement reads as "legal or rights violations" to a model scanning the list above, and pausing on it would be exactly the behavior the next section forbids. The exception covers findings about agent-generated content and about the live environment. A given is not a finding.
This is the expensive instrument: about thirty agents (26 floor, ~31 typical, 42 ceiling), research-heavy and front-loaded, billed to the Claude limit. When the work is genuinely parallel and shallow instead, brute force beats surgery: the Routing section at the end says where each of those jobs goes.
The argument is free-form. Extract:
claim key also works). These are established:
they go straight into the permitted set, skip the audit, and no phase may
question them. Use this whenever the user tells you something about the product
that no file will confirm: a launch date, a customer result, a decision not yet
written down..suede-copy/<slug>/
directory. Must be a draft location: an output path pointing at already
published copy is a halt.{ guidance, emDashes }. guidance is the supplied
author/company voice brief; emDashes is allow or avoid (Suede default).
Translate an explicit punctuation preference into this field so prompts and
deterministic checks agree. Protected source spans remain byte-exact either way.light, standard, or deep. Required, and you must ask the
user rather than pick it (see below). Omitting it defaults to standard.If piece or surface is missing, ask. Do not invent a brief for something a public audience will read.
This is Claude-model fan-out against the user's limit, so the size of the run is
the user's call, not yours. Ask which of these three ranges they want and wait
for an answer before the Workflow call. Do not pick one for them.
| Range | Total agents | What it buys |
|---|---|---|
light | 30–36 | 2 angles, 1 gap fill, 2 findings verified. A short piece, or copy you mostly trust. |
standard | 38–45 | The documented default. 3 angles, 2 gap fills, 4 findings verified. |
deep | 40–50 | 3 gap fills, 6 findings verified. A launch page, pricing page, or anything a stranger will judge the company by. |
Those numbers are measured against the actual script, not estimated, across section counts from 5 to 8 and review findings from 1 to 12 per lens.
Sections are never cut to fit a range: they are the deliverable. The budget scales research depth and verification depth only, and everything it skips is reported as an unverified caveat rather than dropped.
Then state the choice in one line when you launch, this shape:
Running suede-ship-copy on the Agent Studio landing page at
standard: about 40 agents (38-45 depending on section count and findings), on Opus, billed to the Claude weekly limit. Starting now.
Workflow({
scriptPath: "skills/suede-ship-copy/workflows/suede-ship-copy.js",
args: { piece, surface, sources, given, audience, liveUrl, outDir, mustSay, wordBudget, houseStyle, agentBudget }
})
Pass args as a real object. If the harness stringifies it the script recovers,
but an object is correct.
Twelve phases, parallel wherever the edges are not real. This is the logical DAG;
the script's twelve phase() labels fold Claim audit into Gaps and Collision
check into Outline, and split Review and refute and Gate and handoff into
two each. When narrating live progress use the script's labels: there is no phase
called "Claim audit" in /workflows.
file:line, URL, sha, or timestamp.holds,
overstated, unsourceable, or stale. Dropped claims leave the set;
overstated ones are narrowed to what the source supports. The requester's
givens are not in this list and a verdict returned against one is discarded
unread. Nothing downstream may assert a claim outside the permitted set:
surviving agent claims plus every given.[AUTHOR: supply X], never an invention.Every gate in this workflow resolves to a number or a command:
| Check | Threshold |
|---|---|
| Requester's own claims audited | Never. 0 reach the audit. They reach the refute and gate prompts only as named out-of-scope context, never as a target |
| Claim may be asserted | Present in the permitted set (surviving agent claims + every given). Anything else is [AUTHOR: supply X] |
| Finding survives review | 2 of 2 verifiers fail to refute it |
| Findings refuted per run | First 4 blockers/majors; the remainder are logged, never silently dropped |
| Gap fills | First 2; the rest are reported as unread |
| Sections | 3-5 preferred, 7 ceiling |
| Slop Stop score | 35/50 or the piece is REVISE; advisory score only |
| Channel field | chars <= limit per field, counted and reported individually |
| Word count | <= wordBudget × 1.1 when a budget was supplied; unenforced when it was not |
| Em-dash violations | 0 in newly written prose when houseStyle.emDashes is avoid; permitted when allow. Protected strings and givens are exempt |
| Open placeholders | 0, or Status is "ready for author", never "reviewed" |
| Placeholders vanished since draft | 0. A placeholder the assembler or deslop pass resolved away is a fabrication |
| Stalled sections | 0. A writer returning blocked, needs-context, or nothing leaves a hole in the piece |
The six rows from Channel field through Stalled sections are hard gates:
any one fails and hardMechanical forces copyVerdict: hold.
Two more hard gates have no row because they are
liveness rather than quality: a channel-package agent or a deslop agent that
returned nothing also forces hold.
The preceding rows describe claim scope, review, and planning constraints.
The Slop Stop score alone only moves the verdict to ship-with-caveats, never to
hold. Do not report a 22/50 score as a hold.
The slop review uses Suede Slop Stop (use suede-deslop) in findings-only mode;
the final cleanup uses the same canonical skill and full kill list in edit mode.
Make the minimum effective edit, preserve factual wording and exact source spans,
and keep deliberate voice and the supplied house style. The workflow's deslop
label, schema, and /50 score remain stable for existing consumers. Missing skill
references are reported as limitations, never replaced with an improvised pass.
Two conditions stop the run. Neither is a judgement about anything the user said:
halted: true, reason: "output path points at published copy": the requested
outDir points at a live page source, a shipped README, or a sent template rather
than a draft location. Name the path, then offer: write to a draft path beside it,
write to .suede-copy/<slug>/, or confirm the user wants to place it themselves.
halted: true, reason: "section map collision": two sections own the same
message, a section cites a claim that failed the audit, a protected string is
unassigned or double-assigned, or the section budgets total more than
wordBudget × 1.1. Report the collisions. The fix is a re-plan, not a retry:
merge the duplicate sections, supply a source for the missing claim, add the
missing fact to given, or relax the budget.
Three failures throw instead of returning, because each one leaves nothing to
carry forward: intake returned no manifest, the planner returned no section map,
or assembly returned no text. Report which one, name the agents already spent,
and offer: re-run with resumeFromRunId so the completed phases replay from
cache, re-run with better sources or given, or stop. Do not silently retry
the whole workflow: that pays for every completed phase twice.
Do not predict results or narrate progress you cannot see. The workflow returns a
notification when it completes; /workflows shows live progress.
Report faithfully, in this order:
copyVerdict and the deliverable path.stalled: any section whose writer returned nothing usable. The assembled
piece has a hole where that section's message should be. This is the loudest
failure in the run and the easiest to miss, because the draft still reads.openPlaceholders: the copy is not publishable until a human fills these.
Lead with them; they are the honest measure of what nobody could source.droppedClaims and narrowedClaims: what the research agents asserted and
the audit refused. Anyone editing this copy later must not put them back. Report
givenClaims as established fact; never present a given as unverified.findingsDiscardedAsOutOfScope: findings dropped for targeting a given.
Report the count. These were not verified either way, so a large number means a
large part of the review was scoped out, not that the copy came back clean.confirmedFindings, then mechanical, then the deslop score.unread: naming what went unread is most of the honesty.copyVerdict changes what you report, never what the run produced. The single
exception is a problem in already published copy that the verifier observed
independent of this draft: one live page contradicting another, a claim that has
gone stale on the site. That goes to the user immediately.
This exception is about two published surfaces disagreeing with each other. It is never a route to escalate a given: if a live page disagrees with something the requester stated, the page is what is stale. Do not report that as an exposure.
Do not claim published, posted, sent, live, or shipped. This
workflow writes a draft file and reads the live surface. Those states require an
action nobody has taken here.
This workflow must NOT:
outDir: the draft and
the evidence record. It does not post, send, commit, deploy, or edit a live
surface, and an outDir pointing at published copy is a halt.[AUTHOR: supply X] placeholder is the only permitted
answer, and the deslop pass and the assembler are both forbidden from smoothing
one away.docs/assets/suede-ai-logo-transparent.png (sha256
83a7ee0317e4debe2e7b076c20ba067feb76a587f9e829dc6310ae4be4b44dfa). Never
trace, typeset, recolor, distort, or generate a replacement. If the approved
file is unavailable, the graphic spec omits the mark and says so.Edit the script and re-invoke with the same scriptPath. Add
resumeFromRunId: "<run id>" to replay unchanged agents from cache. Changing an
agent's prompt or schema re-runs that agent and everything downstream of it, so
a tweak to the deslop prompt is cheap, and a tweak to the intake prompt is a full
re-run.
suede-graph-flo-xr, which searches
competing implementation plans and mutates only the selected winner.suede-copy.suede-deslop (Suede Slop Stop).johnny-suede-write. Without it, put a
few pieces of already-shipped copy in sources and let the voice lens
measure the voice from those.suede-image.suede-seo-audit, then suede-visibility-grader for the A-F page score.published, posted, sent, live, and shipped are not
states it can claim.johnny-suede-write: route a single high-stakes piece that must survive a
fact audit here; keep multi-surface campaign writing there.