CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workflow-authoring

Reference for writing a Workflow tool script (script API and gotchas, pipeline-vs-barrier rules, quality patterns, worked examples). Load before authoring a script for a workflow the user already opted into; it does not itself authorize running one.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent API reference: executable examples throughout, explicit error-recovery and validation guidance, and tight token efficiency with almost no padding. The main improvement opportunities are splitting the long worked-example catalog into a reference file and consolidating the repeated loop-pattern illustrations.

DimensionReasoningScore

Conciseness

The body is dense, spec-style, and assumes Claude's competence — it never explains general concepts (what subagents or pipelines are in the abstract) and every section carries tool-specific detail. Minor trimmable instances keep it below anchor 5: the conceptual opening paragraph, the loop pattern illustrated twice (loop-until-count then again in the composed example), and a bare time-sensitive version note ('Needs SDK 0.8.20+') placed outside any deprecated/old-patterns section.

4 / 5

Actionability

Fully executable, copy-paste-ready JavaScript throughout: the meta literal template, a complete decide() call with answer extraction, a tools.mcp__linear__list_issues call, the barrier-dedup example, loop-until-count, the adversarial-verify votes, and the composed review pattern — plus complete option enumerations for agent()/pipeline()/parallel() covering the common cases.

5 / 5

Workflow Clarity

Sections are logically sequenced (meta requirements, subagent semantics, hooks, pipeline-vs-barrier decision rules, quality patterns, diagnosis) with explicit validation checkpoints: schema-validated agent output with retry, the 'guard if (!call)' for decide(), loop bounding with round counters, and journal-based diagnosis with a fix-and-relaunch recovery loop. It falls short of anchor 5 only in that no single end-to-end authoring checklist ties the sections into one procedure.

4 / 5

Progressive Disclosure

No bundle files exist, and the single self-contained SKILL.md is well-sectioned with clear, ordered headers ('What a subagent is', 'Script body hooks', 'Pipeline vs barrier', 'Quality patterns', 'Diagnosing a run') making it easy to navigate. At roughly 265 lines the worked examples and pattern catalog are inlined in one monolithic file where an examples/reference split could apply, which is the minor organization gap that keeps it at anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states what the reference covers with concrete enumerated areas, gives an explicit and well-gated trigger condition, and adds a scope boundary that reduces mis-triggering. Its only weakness is modest synonym coverage around orchestration terminology.

DimensionReasoningScore

Specificity

The description names its domain and enumerates several concrete content areas — 'script API and gotchas, pipeline-vs-barrier rules, quality patterns, worked examples' — going beyond the 1-2 items of anchor 3, but it catalogs coverage areas rather than comprehensively listing capabilities, so it stops short of anchor 5.

4 / 5

Completeness

Both parts are explicit: the 'what' ('Reference for writing a Workflow tool script (script API and gotchas, pipeline-vs-barrier rules, quality patterns, worked examples)') and a concrete, gated 'when' ('Load before authoring a script for a workflow the user already opted into'). The when-clause is specific and even adds a scope boundary ('it does not itself authorize running one'), so it is not the anchor-4 case of a when that could be more explicit.

5 / 5

Trigger Term Quality

'Workflow tool script', 'authoring', and 'pipeline' are natural terms a user would say when needing this skill, giving good keyword coverage; common variations like 'orchestrate', 'multi-agent', or 'fan out' are absent, which keeps it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Workflow tool script' occupies a clear niche tied to a specific tool, and the explicit negative boundary ('it does not itself authorize running one') further separates it from generic workflow-execution triggers, giving minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

letta-ai/letta-code

Path

src/skills/builtin/workflow-authoring/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.