CtrlK
BlogDocsLog inGet started
Tessl Logo

form-auto-save

Automatic form submission after user input changes using a debounce mechanism to prevent excessive server requests. Creates a seamless auto-save experience for forms with rich text editors or multiple fields.

59

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/form-auto-save/SKILL.md
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.

This is a strong, highly actionable pattern document: complete controller, view, and test code that can be used verbatim, with a thoughtful event-count-based testing approach and troubleshooting section. Its main weaknesses are redundancy between the Key Features list and the Important Considerations subsections, and everything being inlined in SKILL.md rather than split into reference files.

Suggestions

Collapse the 'Debounce Time', 'Event Listeners', and 'Turbo Permanent' subsections into the Key Features bullets to remove repetition, and drop the Overview that restates the frontmatter description.

Move the controller source and spec/helper code into a references/ file, keeping SKILL.md as an overview with clearly signaled one-level-deep links.

Replace the vague 'Stimulus Values' related-pattern bullet with a concrete pointer or delete it.

DimensionReasoningScore

Conciseness

The Overview repeats the frontmatter description nearly verbatim, and the 'Debounce Time', 'Event Listeners', and 'Turbo Permanent' subsections restate facts already given in Key Features and the code. There is also inferred-for-Claude padding ('too short = excessive requests, too long = lost changes'), matching the mostly-efficient-with-some-unnecessary-explanation anchor rather than the minor-trimming anchor.

3 / 5

Actionability

The body provides a complete, executable Stimulus controller, an exact Slim view snippet with required data attributes, a full RSpec helper with its file path, and two runnable system specs — copy-paste ready and covering the common cases including debounce behavior. This matches the fully-executable top anchor.

5 / 5

Workflow Clarity

Sections are clearly sequenced (controller → view integration → testing) and the Common Issues section gives check-then-fix recovery loops, with the testing section supplying the verification checkpoint (countValue polling). It falls short of the top anchor because steps are not explicitly ordered with validate-before-proceed checkpoints and one 'Related Patterns' bullet ('Stimulus Values') is under-specified.

4 / 5

Progressive Disclosure

The body is well organized with clear section headers, and the References section points to one-level-deep external URLs that are clearly signaled. However, the skill is well over 50 lines with no bundle files — the full controller, helper, and spec code are inlined where a reference file could carry them — so it is good-but-not-optimally split rather than a clear overview with well-signaled file references.

4 / 5

Total

16

/

20

Passed

Description

61%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 communicates a concrete capability (debounced automatic form submission) with decent natural keywords, but lacks an explicit 'Use when...' trigger clause and pads its second sentence with 'seamless experience' phrasing instead of additional concrete actions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when implementing auto-saving forms, or when the user mentions auto-save, drafts, or preventing data loss on navigation.'

Replace 'Creates a seamless auto-save experience' with concrete capabilities (e.g. 'cancel and submit programmatically', 'preserve unsaved state across Turbo navigation').

Include natural synonyms such as 'autosave' and 'save drafts' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action ('Automatic form submission after user input changes using a debounce mechanism'), but does not list several specific actions; 'Creates a seamless auto-save experience' is generic phrasing. It fits the anchor for domain plus 1-2 concrete actions rather than the several-actions anchor above.

3 / 5

Completeness

The 'what' is clear (automatic submission after changes with debounce), but there is no explicit 'Use when...' clause or equivalent trigger guidance — applicability is only weakly implied by 'for forms with rich text editors or multiple fields'. Per the rubric, a missing explicit trigger clause caps completeness at 3; it is not 2 because the 'what' is fully concrete.

3 / 5

Trigger Term Quality

Natural terms like 'auto-save', 'form submission', 'debounce', 'rich text editors', and 'multiple fields' give good keyword coverage a user would plausibly say. It falls short of the comprehensive anchor because synonyms such as 'autosave', 'draft saving', or explicit trigger phrasing are missing.

4 / 5

Distinctiveness Conflict Risk

'Auto-save', 'debounce', and 'rich text editors' carve a clear niche unlikely to fire for unrelated skills. Minor overlap risk remains with generic form-handling or form-validation skills, so it is mostly distinct rather than fully minimal-conflict.

4 / 5

Total

14

/

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
RoleModel/rolemodel-skills
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.