CtrlK
BlogDocsLog inGet started
Tessl Logo

idempotent-script-design

Use this skill when writing scripts, cron jobs, data pipelines, or any automated process that may be run multiple times. Design every operation to be safely re-runnable without side effects.

76

Quality

95%

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

100%Weight 40%Scale 1-3

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

The content is a model of conciseness and actionability, packing concrete, executable techniques into a short, well-organized body with a clear verification step and no token waste.

DimensionReasoningScore

Conciseness

The body is lean: a one-line definition followed by concrete bullet techniques with code fragments, with no padding explaining concepts Claude already knows. Every token earns its place.

3 / 3

Actionability

Provides concrete, executable guidance such as `CREATE TABLE IF NOT EXISTS`, `mkdir -p`, `INSERT ... ON CONFLICT DO UPDATE`, and 'Write to a temp file, then rename' — specific enough to act on directly.

3 / 3

Workflow Clarity

A simple single-purpose skill under 50 lines whose single action is unambiguous; the 'Testing idempotency' section gives a clear run-twice-and-verify sequence with no destructive workflow requiring checkpoints.

3 / 3

Progressive Disclosure

A short, well-organized skill with clear sections (Techniques, Testing idempotency, Anti-patterns) and no need for external references; no bundle files are present to verify.

3 / 3

Total

12

/

12

Passed

Description

90%Weight 40%Scale 1-3

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 well-constructed with an explicit trigger clause and natural user-facing terms covering a distinct niche. It is slightly held back on specificity by framing a single abstract design principle rather than enumerating multiple concrete operations.

Suggestions

Consider listing one or two more concrete operations (e.g., 'use upserts, atomic writes, and completion markers') to lift specificity from abstract principle to a multi-action enumeration.

DimensionReasoningScore

Specificity

Names concrete domains ("writing scripts, cron jobs, data pipelines") and a design action ("Design every operation to be safely re-runnable without side effects"), but describes a single abstract design principle rather than listing multiple discrete concrete operations.

2 / 3

Completeness

Explicitly answers both what ("Design every operation to be safely re-runnable without side effects") and when ("Use this skill when writing scripts, cron jobs, data pipelines..."), with an explicit trigger clause.

3 / 3

Trigger Term Quality

Uses natural terms a user would actually say — "scripts, cron jobs, data pipelines, or any automated process that may be run multiple times" — with good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (idempotent/re-runnable automated processes) with distinct triggers unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

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.

Validation15 / 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
aiming-lab/MetaClaw
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.