CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-graphs

Create and manage agent graphs — directed graphs of configs connected by edges with handoff logic. Use when building multi-agent workflows where configs route to each other.

64

Quality

81%

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

75%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.

A well-structured, actionable skill body: clear domain semantics, a concrete create example, a sequenced workflow with a verification step, and useful edge-case and anti-pattern sections. The main improvements are trimming generic principle advice and adding an error-recovery loop to the workflow.

Suggestions

Cut or tighten the 'Core Principles' section — 'Design Before Building' and 'One Agent, One Job' are guidance Claude already applies.

Add an error-recovery loop after Step 4, e.g. 'If get-agent-graph shows wrong edges or root config, fix with update-agent-graph and re-verify'.

Move the per-tool parameter documentation into a references/ file (or trim it to the essential create-agent-graph payload) and keep SKILL.md as the overview.

DimensionReasoningScore

Conciseness

The body is efficient — tool lists, a concrete JSON example, and tables carry the weight. The 'Core Principles' section ("Design Before Building: Map out nodes and edges on paper/whiteboard first", "One Agent, One Job") is generic advice Claude doesn't need, which keeps it at anchor 4 rather than 5, but it's the only notable padding so it sits above anchor 3.

4 / 5

Actionability

"Use `create-agent-graph` with: `projectKey`... `rootConfigKey`... `edges`" plus a complete, copy-paste-ready JSON example gives concrete executable guidance. Minor gaps — e.g. `update-agent-graph` is referenced with no example payload — hold it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The four-step workflow (Design → Ensure Nodes Exist → Create → Verify) is clearly sequenced with explicit validation in Step 4 ("Use `get-agent-graph` to confirm the graph was created with the correct structure") and pre-flight checks ("Check existing graphs with `list-agent-graphs` to avoid duplicates"). It lacks an error-recovery loop for failed or mis-validated creation, so it doesn't reach anchor 5.

4 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-sectioned with one clearly-signaled, one-level external reference ("read [Agent graphs](https://launchdarkly.com/docs/...)"). At ~144 lines with inlined per-tool parameter documentation it exceeds the simple-skill case that would merit a 5, but structure and navigation are good — anchor 4.

4 / 5

Total

16

/

20

Passed

Description

78%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 defines the concept concisely, includes an explicit 'Use when' trigger clause, and uses natural domain vocabulary. Its weaknesses are a thin action list (create/manage) and a broad multi-agent trigger that doesn't name the specific product context.

Suggestions

Expand the action list beyond create/manage, e.g. add 'inspect and update edges, set the root config, and verify routing between configs'.

Name the platform (LaunchDarkly) in the description to reduce overlap with generic multi-agent workflow skills.

Add one or two common synonyms such as 'agent orchestration' or 'routing between agents' to the trigger clause.

DimensionReasoningScore

Specificity

"Create and manage agent graphs" names the domain but lists only two actions, and "manage" is generic; the remainder of the description is a structural definition rather than additional concrete actions. This matches anchor 3 (1-2 concrete actions, not comprehensive) — not 4, which requires several specific actions.

3 / 5

Completeness

The what is explicit ("Create and manage agent graphs — directed graphs of configs connected by edges with handoff logic") and the when is an explicit trigger clause ("Use when building multi-agent workflows where configs route to each other"). Both are concrete, matching anchor 5 rather than 4, where the 'when' would be less specific.

5 / 5

Trigger Term Quality

Terms like "agent graphs", "multi-agent workflows", "handoff logic", and "route to each other" give good natural keyword coverage. It falls short of anchor 5 because common synonyms such as "agent orchestration", "routing between agents", or "agent chaining" are missing.

4 / 5

Distinctiveness Conflict Risk

The config/edge/handoff vocabulary carves a fairly distinct niche, but the trigger "building multi-agent workflows" is broad and could overlap other agent-building skills since the product (LaunchDarkly) is not named in the description. Mostly distinct with minor overlap risk — anchor 4, not 5.

4 / 5

Total

16

/

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
launchdarkly/ai-tooling
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.