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

87%

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

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-engineered instruction skill: the phased workflow with verification gates, feedback loops, and rollback criteria is about as clear as workflow guidance gets, and templates make the deliverables concrete. The main improvable areas are trimming the diagram/section duplication and giving the exact Quint CLI syntax for invariant/witness selection at the gates.

Suggestions

Show the exact `quint run` invocation for selecting an invariant or witness (the actual flag and argument form) in the Phase 3 tool table and Phase 4 sections, so the verification gates are copy-paste executable.

Remove the ASCII phase diagram or the redundant prose re-descriptions of Phases 0–4 — keeping one of the two would cut ~30–40 lines and tighten the token budget.

Consolidate the repeated context-compaction advice (target 40–60%, 'under 300 lines', the status block) into a single section, and consider moving the detailed spec-change protocol or tool reference into a one-level-deep reference file to keep SKILL.md a leaner overview.

DimensionReasoningScore

Conciseness

The body is overwhelmingly directive — 'Never modify the spec to make a failing verification pass', 'Run `quint typecheck` and fix all reported errors' — with no concept explanations Claude already knows. However, the 38-line ASCII workflow diagram duplicates the detailed Phase 0–4 sections that follow, and the compaction/compact-context advice ('Catalog the codebase compactly', 'Target: under 300 lines', the status block) recurs across three sections. This is 'minor instances that could be trimmed' (4), not fully lean (5) but well above noticeably verbose (2–3).

4 / 5

Actionability

Highly concrete: exact commands ('quint typecheck', 'quint run', 'quint verify', '--max-samples 5000'), a copy-paste plan-format template, a research prompt template, a compaction status template, and a tool-usage table. The gap that keeps it at 4 rather than 5 is that the pivotal gate syntax is never shown — how to select an invariant or witness in `quint run` (e.g. the actual flag) is implied ('with witness as invariant', 'with those invariants') but not executable as written, and 'quint REPL session + quint REPL eval' is not a verifiable command form.

4 / 5

Workflow Clarity

Exemplary sequencing: Phases 0–4 with a verification gate after every implementation step, rollback criteria in the plan template, explicit feedback loops ('If the gate fails: stop, diagnose, return to Phase 2', 'If invariant `[name]` fails after Step N, stop and return to planning'), a spec-change protocol requiring user approval, and failure-mode guidance for both violated invariants and unreachable witnesses. This matches the 5 anchor (explicit validation, error-recovery loops, checklist-style anti-pattern table).

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the skill is a self-contained ~260-line workflow with well-organized, consistently headed sections; nothing is buried or nested. It stays at 4 rather than 5 because the single file carries material that could be split — the detailed per-phase bodies restate the overview diagram, and the tool-usage/spec-change detail could live in one-level-deep reference files to keep SKILL.md a leaner overview. This is 'good structure with minor organization gaps', not the ideal overview-plus-signaled-references split of 5.

4 / 5

Total

17

/

20

Passed

Description

87%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: it states the domain, the concrete change types it handles, and an explicit 'Use when...' trigger clause in third person without padding. The only weakness is modest coverage of the skill's full capability set (verification gates, spec-change protocol) and a missing '.qnt' extension trigger.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — 'refactor code', 'add a new feature', 'close a gap between implementation and spec' — anchored by 'Implement code against an existing Quint specification'. Not comprehensive: the spec-change protocol and verification-gate capabilities that dominate the skill body are absent, which is the 'minor gaps' of the 4 anchor rather than the full coverage of 5.

4 / 5

Completeness

Explicitly answers both: what — 'Implement code against an existing Quint specification. Uses Research → Plan → Implement workflow (ACE-FCA style) grounded by the spec as the source of truth' — and when — 'Use when the user wants to refactor code, add a new feature, or close a gap between implementation and spec'. Both are present, explicit, and use concrete trigger phrases, matching the 5 anchor exactly; the 4 anchor requires a 'when' that could be more specific, which is not the case here.

5 / 5

Trigger Term Quality

Good natural phrases users would say: 'refactor code', 'add a new feature', 'close a gap between implementation and spec', 'Quint spec'. A few common variations are missing — e.g. the '.qnt' file extension (used only in the body) and phrasings like 'implement the spec' or 'make the code match the spec' — so it fits the 4 anchor ('a few natural terms missing') rather than the comprehensive synonym/extension coverage of 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Quint-spec-driven implementation — with distinct triggers ('existing Quint specification', spec/implementation gap). It is clearly separable from generic refactor/coding skills, and the 'existing' qualifier distinguishes it from a spec-creation companion skill. Minimal conflict risk, matching the 5 anchor; it is well above the 'minor overlap risk with closely related skills' of the 4 anchor.

5 / 5

Total

18

/

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

.agents/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.