CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-harness-dependencies

Update the primary SDK dependencies of harness packages. Use when asked to update the harness SDKs or harness adapter dependencies.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a lean, fully executable runbook: exact pnpm commands per harness, explicit bridge-dependency handling, a pinned-CLI update flow, an SDK sweep with justified placeholders, and a verification step with a fix-and-rerun feedback loop. Only minor issues hold it back — slight preamble/replication redundancy and a small heading-hierarchy quirk around the fx and example sections.

DimensionReasoningScore

Conciseness

The body is nearly all executable commands and assumes pnpm competence without explaining basics, but small padding exists ("It is crucial to keep those dependencies up to date") and the ACP example command is repeated verbatim in both the exact-commands block and the templated section. This matches anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5's "every token earns its place".

4 / 5

Actionability

Every command is copy-paste ready and covers each harness explicitly; the two templated commands use placeholders that are explicitly justified with worked examples, and the fx flow includes the exact curl command, the file to edit, and the test command. Fully executable guidance matching anchor 5.

5 / 5

Workflow Clarity

The sequence is clear (harness deps, bridge deps, pinned fx version, example alignment, SDK sweep, verification) with explicit validation: the verify script plus a feedback loop ("If this script shows errors, you must address them, then rerun the verification script until it passes") and fx tests after the version bump. Although this is a batch operation, validation is present, so the workflow-clarity cap at 3 does not apply; it matches anchor 5.

5 / 5

Progressive Disclosure

With no bundle files, all content is appropriately inline and organized into clear sections with good navigation. Minor organization gaps remain: "Update the pinned fx CLI version" and "Example dependencies" sit as #### subsections under "Update the harness dependency packages" despite being distinct tasks, slightly muddying the hierarchy — anchor 4 (good structure, minor gaps) rather than anchor 5.

4 / 5

Total

18

/

20

Passed

Description

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

The description is concise, uses third person, explicitly answers both what and when, and carves out a distinct niche with minimal conflict risk. Its weakness is moderate keyword coverage: it captures the obvious phrasings but no synonyms or variations, and it names only a single aggregate action rather than the skill's concrete sub-capabilities.

Suggestions

Add common user phrasings and synonyms to the trigger clause, e.g. "Use when asked to update, upgrade, or bump harness SDK or adapter dependencies to their latest versions."

Name one or two concrete sub-capabilities in the "what" sentence (e.g. aligning SDK versions across adapters, bridges, and examples, then verifying alignment) to raise specificity beyond a single aggregate action.

DimensionReasoningScore

Specificity

"Update the primary SDK dependencies of harness packages" names the domain and one concrete action but is not comprehensive — it does not enumerate the sub-capabilities (bridge deps, pinned CLI versions, example alignment, verification). It fits anchor 3: domain plus 1-2 concrete actions; it is not anchor 4 (no list of several specific actions) nor anchor 2 (the action is concrete, not generic).

3 / 5

Completeness

The description has a clear "what" ("Update the primary SDK dependencies of harness packages") and an explicit trigger clause ("Use when asked to update the harness SDKs or harness adapter dependencies") with concrete trigger phrases. Both what and when are explicitly answered, matching anchor 5 rather than anchor 4 (where the "when" would only be present but less explicit).

3 / 5

Trigger Term Quality

Trigger terms like "update the harness SDKs" and "harness adapter dependencies" are relevant and natural, but the description misses common variations and synonyms a user might say ("upgrade", "bump", "latest versions"). This matches anchor 3 (some relevant keywords, missing common variations) rather than anchor 4's broader coverage.

3 / 5

Distinctiveness Conflict Risk

The niche is highly specific to harness packages/adapter SDK dependencies — a domain few other skills would claim — and the triggers ("harness SDKs", "harness adapter dependencies") are distinct. Minimal conflict risk, matching anchor 5.

5 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

vercel/ai

Path

skills/update-harness-dependencies/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.