CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reliable-mutations

How the agent must perform writes so they actually persist under the hosted foreground run budget and long-running background handoffs. Use whenever you create, update, delete, or batch-write app data — especially "do this for many items" loops, or any task where the user expects N things to end up saved.

Quality

85%

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

86%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 behavioral skill: a lean body with concrete, executable directives, explicit verification and fail-loud checkpoints for batch writes, and clean cross-references. The only notable gaps are minor How/Don't redundancy and the absence of a recovery path for a failed verification.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — the Why section explains only non-obvious platform constraints ("Hosted foreground agent runs have a short soft budget so they can hand off cleanly under synchronous serverless walls") rather than concepts Claude already knows. It is not 5 because the Don't section restates How steps 2 and 4 ("Don't loop `for each item: write(item)`" repeats step 2; "Don't claim completion because every tool call returned ✓" repeats step 4), a minor redundancy that could be trimmed.

4 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: "pass the full batch in one call", "Check the action surface for a batch/plural form", "Re-read the data (a list/read action, a count query) and confirm the result matches intent — the right number of rows, the expected ids/fields", with copy-ready report examples ("saved 12 of 12 panels (ids …)", "updated 5 rows") and explicit partial-failure reporting ("report what *did* persist (M of N)"). The decision procedure covers the common cases concretely.

5 / 5

Workflow Clarity

The How section is a clearly sequenced 5-step procedure with an explicit validation checkpoint — "Verify the end state after writing … Do this before you tell the user it worked" — and explicit failure handling ("On a time-budget cutoff, fail loud … report what *did* persist (M of N) and what remains"), satisfying the batch-operation validation requirement. It is not 5 because no instruction covers what to do when verification itself shows a mismatch (fix-and-retry vs. report-failure), and the only recovery path ("add or extend an action that accepts the batch") addresses a missing tool rather than a failed verification.

4 / 5

Progressive Disclosure

This is a short, single-purpose, self-contained skill with no bundle files, and the body is well organized into Rule / Why / How / Don't / Related — exactly the case the rubric says can score 5 on well-organized sections alone. The Related section cleanly signals one-level-deep pointers (`actions`, `storing-data`, `performance`, and the design-doc path) with no nesting or buried references.

5 / 5

Total

18

/

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 that clearly and explicitly answers both what the skill governs and when to use it, with unusually natural trigger phrasing ("do this for many items", "N things to end up saved"). The main deductions are the second-person voice in the trigger clause and trigger coverage that leans on internal jargon ("hosted foreground run budget") over user-facing synonyms.

Suggestions

Rewrite the trigger clause in third person (e.g., "Use whenever the agent creates, updates, deletes, or batch-writes app data") to remove the second-person penalty on specificity.

Add natural user-facing synonyms such as "bulk", "save", or "import many" to the trigger phrasing to broaden keyword coverage beyond create/update/delete/batch-write.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "create, update, delete, or batch-write app data" — which would anchor at 4 (several specific actions, minor gaps), but the trigger clause uses second person ("Use whenever you create, update, delete, or batch-write app data"), which the judging guidelines penalize by reducing specificity by 1. The base is not 5 because the action verbs are generic CRUD terms and the framing "How the agent must perform writes so they actually persist" describes manner rather than enumerating the full capability set (verification and proof-reporting are absent).

3 / 5

Completeness

Both what and when are explicit. What: "How the agent must perform writes so they actually persist under the hosted foreground run budget and long-running background handoffs." When: "Use whenever you create, update, delete, or batch-write app data — especially 'do this for many items' loops, or any task where the user expects N things to end up saved." This matches the anchor for clearly and explicitly answering both what AND when with concrete trigger phrases; the when-clause even includes an explicit "especially" prioritization.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "create, update, delete, or batch-write app data", "'do this for many items' loops", and "any task where the user expects N things to end up saved" mirror what users actually say. It is not 5 because common synonyms like "bulk", "save", "mass update", or "import" are missing, and "hosted foreground run budget" / "long-running background handoffs" are internal jargon no user would say. It is above 3 because the when-clause terms are concrete and varied rather than a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

There is a clear niche — write reliability and atomic persistence behavior — with distinct triggers ("batch-write", "N things to end up saved"). It is not 5 because "Use whenever you create, update, delete, or batch-write app data" fires on virtually every mutation, creating minor overlap risk with closely related storage/data skills (the body itself lists `storing-data` and `actions` as neighbors). It is well above 3 because the persistence-under-budget framing is unlike any generic data-skill description.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/reliable-mutations/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.