CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-prototype-lock

This skill should be used when the user says "prototype lock", "lock prototype", "arn prototype lock", "freeze prototype", "preserve prototype", "snapshot prototype", "protect prototype", "archive prototype", "save the prototype", "don't overwrite the prototype", "lock the design", "freeze the design", or wants to create a frozen snapshot of the validated prototype before development begins, preventing production code from overwriting the validated reference artifact.

64

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-spark-prototype-lock/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 excels at trigger term coverage and completeness, providing an extensive list of natural phrases users might say and clearly stating both what the skill does and when to use it. Its main weakness is that the 'what it does' portion is somewhat abstract — it describes the concept (frozen snapshot, preventing overwrites) but doesn't detail the concrete actions or mechanisms involved. The heavy emphasis on trigger phrases is effective for skill selection but comes at the cost of specificity about capabilities.

Suggestions

Add more concrete action details to the 'what' portion, e.g., 'Creates a timestamped read-only copy of the prototype file, generates a lock manifest, and sets file permissions to prevent modification.'

DimensionReasoningScore

Specificity

The description mentions creating a 'frozen snapshot of the validated prototype' and 'preventing production code from overwriting the validated reference artifact,' which names the domain and a couple of actions, but doesn't list multiple concrete specific actions (e.g., what files are created, what format, what locking mechanism is used).

2 / 3

Completeness

The description explicitly answers both 'what' (creates a frozen snapshot of the validated prototype before development begins, preventing production code from overwriting the validated reference artifact) and 'when' (with an extensive list of trigger phrases and the condition 'when the user wants to create a frozen snapshot...'). The 'Use when' equivalent is clearly present.

3 / 3

Trigger Term Quality

The description provides extensive natural trigger phrases users would say: 'prototype lock', 'lock prototype', 'freeze prototype', 'preserve prototype', 'snapshot prototype', 'protect prototype', 'archive prototype', 'save the prototype', 'don't overwrite the prototype', 'lock the design', 'freeze the design'. This is thorough coverage of natural variations.

3 / 3

Distinctiveness Conflict Risk

The description targets a very specific niche — locking/freezing a validated prototype artifact before development — with highly distinctive trigger terms like 'prototype lock', 'freeze prototype', 'arn prototype lock'. This is unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

62%

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

This is a thorough, highly actionable skill with excellent workflow clarity and validation checkpoints. Its main weakness is extreme verbosity — it reads more like a detailed specification document than a concise skill instruction, with many sections that could be condensed by 50-70% without losing actionable information. The progressive disclosure is partially implemented through template references but the main file itself carries too much inline detail.

Suggestions

Dramatically reduce verbosity: condense the framework detection table to essential differences only, remove verbose user-facing message templates (Claude can compose these), and trim explanatory text that describes what Claude already understands (e.g., how git tags work, what node_modules is).

Move the framework copy strategy table and error handling section to separate reference files, keeping only a brief summary inline with pointers to the detailed references.

Remove verbatim user-facing dialogue scripts — instead provide a brief note on what information to communicate, trusting Claude to compose appropriate messages.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~250+ lines. It over-explains many steps that Claude could infer (e.g., how to detect frameworks, how cp -r works, how git tags work). The framework detection table, the detailed copy strategy table, and the extensive error handling section could all be significantly condensed. Many conversational prompts are spelled out verbatim when a brief instruction would suffice.

1 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific shell commands (git tag -a, chmod +x, cp -r), specific file paths, specific framework detection strategies with exact config file names, and exact validation commands per framework. The workflow is copy-paste actionable with real commands and clear decision trees.

3 / 3

Workflow Clarity

The 9-step workflow is clearly sequenced with explicit validation checkpoints (Step 4 validates the build, Step 5 asks user to confirm access), feedback loops (retry up to 3 times on build failure), and clear decision points (user confirmation gates at Steps 1, 2, 5, and 8). Error recovery paths are well-defined throughout.

3 / 3

Progressive Disclosure

The skill references external templates (lock-report-template.md, prototype-guardrail-rules.md, pretooluse-hook-template.json) which is good progressive disclosure, but the main SKILL.md itself is monolithic with extensive inline content that could be split out. The framework detection table and error handling could be separate reference files. No bundle files were provided to verify the referenced templates exist.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.