CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

quint-execute-spec

Implement code against an existing Quint specification. Uses Research → Plan → Implement workflow (ACE-FCA style) grounded by the spec as the source of truth. Use when the user wants to refactor code, add a new feature, or close a gap between implementation and spec — with the Quint spec as the formal constraint that all changes must satisfy.

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

The canonical home for this skill is quint-execute-spec in crocoder-dev/shared-context-engineering

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-built workflow skill: precise phased sequencing with explicit Quint verification gates, feedback loops, and rollback criteria. The main improvements are tightening redundancy (duplicate lightweight-path sections, diagram vs. prose), adding complete command invocation examples, and splitting detailed phase material into reference files.

Suggestions

Merge the two lightweight-path sections (Phase 0 note and the trailing 'Lightweight path for simple changes') into one, and trim 'What NOT to do' rows that restate rules already stated inline.

Show at least one complete invocation (e.g. 'quint run model.qnt --invariant myInvariant --max-samples 5000') so commands are copy-paste ready, and clarify the REPL row with an actual command form.

Move the detailed phase bodies (plan format template, spec-change protocol, gap-analysis prompt) into references/ files, keeping SKILL.md as a compact overview with one-level-deep pointers.

DimensionReasoningScore

Conciseness

Efficient overall — nearly every section carries novel workflow instructions (verification gates, spec-change protocol, plan template) rather than concepts Claude already knows. Not 5 because of genuine redundancy: the lightweight path is stated twice ('Lightweight path (skip research...)' in Phase 0 and 'Lightweight path for simple changes' at the end), the workflow diagram duplicates the phase prose, and the 'What NOT to do' table reiterates rules already stated inline.

4 / 5

Actionability

Mostly executable: concrete commands ('quint typecheck', 'quint run' with '--max-samples 5000', 'quint verify', 'quint test'), a fill-in plan format, a status-compaction template, and a gap-analysis prompt. Not 5 because no complete copy-paste command invocations are shown (e.g. 'quint run spec.qnt --invariant <name>') and the REPL row ('quint REPL session' + 'quint REPL eval') is vague.

4 / 5

Workflow Clarity

Clear phased sequence (Phase 0-4) with explicit validation gates after each implementation step, feedback loops on failure ('If the gate fails: stop, diagnose, return to Phase 2'), rollback criteria, a violated-invariant recovery procedure, and an anti-pattern checklist. Matches the top anchor: explicit validation steps, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

Good structure: clear section headers, a workflow overview diagram, and a tool-usage table, all appropriately inlined for a single-file workflow skill (no bundle files exist). Not 5 because there are no reference files at all and the file is ~260 lines — the detailed phase bodies (plan format, spec-change protocol) could be split into one-level-deep references to keep SKILL.md a leaner overview.

4 / 5

Total

17

/

20

Passed

Description

83%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: concrete actions, an explicit 'Use when' trigger clause, and a well-defined Quint-spec niche with a clear boundary against the sibling quint-modeling skill. Weaknesses are minor — a few missing natural terms (.qnt extension, spec-first) and slightly generic refactor/feature triggers.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Implement code against an existing Quint specification', 'refactor code', 'add a new feature', 'close a gap between implementation and spec' — with only minor gaps in coverage (sub-actions like running verification gates are not enumerated). Not 5 because coverage is not comprehensive and 'ACE-FCA style' is unexplained jargon; not 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

Explicitly answers both: what ('Implement code against an existing Quint specification. Uses Research → Plan → Implement workflow...') and when ('Use when the user wants to refactor code, add a new feature, or close a gap between implementation and spec') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'refactor code', 'add a new feature', 'gap between implementation and spec', 'Quint specification'. Not 5 because common variations are missing — the '.qnt' file extension and phrases like 'spec-first' or 'implement from the spec' appear only in the body, not the description.

4 / 5

Distinctiveness Conflict Risk

Clear Quint-spec niche with distinct triggers and an explicit handoff boundary ('If no spec exists yet, use quint-modeling'). Not 5 because 'refactor code' and 'add a new feature' are generic phrases that a user could say in a non-Quint context, creating minor overlap risk with general coding skills.

4 / 5

Total

17

/

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

crocoder-dev/shared-context-engineering

Path

.claude/skills/quint-execute-spec/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.