CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

quint-lang

Quint language and CLI reference — the expert on Quint syntax, operators, types, `basicSpells`, the toolchain (typecheck/run/test/verify), and how to read simulation and counterexample output. Use when writing or debugging the contents of a `.qnt` file, fixing a typecheck/parse error, looking up an operator or idiom, analyzing an invariant violation or counterexample trace, or optimizing state-space exploration. This is for working IN Quint at the language level — not for analyzing or running TLA+/TLC itself. For building a NEW model end-to-end from some source — including translating a TLA+ spec into Quint, or modeling code/requirements/an idea — use the quint-modeling skill, which owns that workflow and consults this reference for syntax. Keywords: quint, syntax, operators, typecheck, model checking, counterexample, basicSpells, CLI, specification language.

Quality

86%

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

67%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 dense, largely executable quick reference with exemplary operator tables, decision guides, and a clean two-file layout convention. Its main weaknesses are redundant variable-grouping guidance repeated across three sections, one cryptic reference to external 'indexing' tooling, and guideline files referenced but absent from the bundle.

Suggestions

Consolidate the three treatments of when-to-group-variables ('Records as state — when to group variables', the 'Variable grouping — decision guide' table, and the grouped example in 'State variables') into a single section with one example and one decision table.

Clarify or remove 'The primitive's module_name field (set during indexing) always holds the correct value' — it depends on tooling context this skill does not define; state the rule in terms of where the property is defined instead.

Verify the guidelines/*.md files referenced in the Guidelines table ship with the skill bundle, or inline the minimal needed content so navigation does not break.

DimensionReasoningScore

Conciseness

Operator tables and code blocks are lean (results inline as comments, minimal prose), but the when-to-group-variables guidance is presented three times — the 'Records as state — when to group variables' bullets and preferred/avoid examples, the near-duplicate 'Variable grouping — decision guide' table, and the grouped LocalState example in 'State variables' — and the Phase enum is re-shown in three sections. This is more than 'minor' trimming (anchor 3, 'could be tightened'), not 4.

3 / 5

Actionability

Nearly all guidance is executable with expected results ('Set(1, 2).union(Set(2, 3)) // Set(1, 2, 3)', the --main table, the `run quorumAssumptionTest` example, the file-layout convention). Minor gaps keep it at 4 rather than 5: the unexplained 'The primitive's `module_name` field (set during indexing) always holds the correct value' references external tooling a reader cannot act on, and several snippets carry placeholder comments ('// ... other vars unchanged').

4 / 5

Workflow Clarity

A reference skill, but content is sequenced the way a spec is written (module structure → types → definitions → state → actions → nondeterminism → operators → CLI/file layout), with a concrete two-file split, a --main selection table, and a validation loop for assumptions ('Run it with `quint test`; the test fails (reporting which conjunct broke)'). Matches anchor 4 — the typecheck→test→verify toolchain order itself is deferred to guidelines/cli.md, a minor checkpoint gap; no destructive/batch cap applies.

4 / 5

Progressive Disclosure

Good structure: quick-reference content inline, with details deferred through a clearly signaled, one-level-deep Guidelines table that summarizes each guidelines/*.md file. It falls short of 5 because the seven referenced guideline files are not present in the bundle being evaluated, and the ~550-line body inlines deep-dive material (records grouping, sum types, nested updates) that could live in those files — anchor 4 ('minor organization gaps').

4 / 5

Total

15

/

20

Passed

Description

100%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.

An exemplary description: concrete capability list, explicit 'Use when' triggers with the .qnt extension and natural keywords, and explicit boundaries against both TLA+/TLC work and the sibling quint-modeling skill. Third-person voice is maintained and nothing is padded or over-claimed.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'writing or debugging the contents of a `.qnt` file, fixing a typecheck/parse error, ... analyzing an invariant violation or counterexample trace, or optimizing state-space exploration' — with comprehensive coverage of the skill's scope (syntax, operators, types, basicSpells, toolchain, output interpretation). This matches the 5 anchor ('Lists multiple specific concrete actions; comprehensive coverage'); it is not 4 because no capability area is missing.

5 / 5

Completeness

It explicitly answers both questions: what ('Quint language and CLI reference — the expert on Quint syntax, operators, types, basicSpells, the toolchain...') and when ('Use when writing or debugging the contents of a .qnt file, fixing a typecheck/parse error, looking up an operator or idiom...'). Concrete trigger phrases for both — matches the 5 anchor; the 'when' clause is explicit, not weakly implied (which would cap it at 3-4).

5 / 5

Trigger Term Quality

Natural trigger terms are comprehensive: 'quint, syntax, operators, typecheck, model checking, counterexample, basicSpells, CLI, specification language', plus the `.qnt` file extension in the 'Use when' clause. Matches the 5 anchor ('Comprehensive coverage of natural terms including synonyms and file extensions').

5 / 5

Distinctiveness Conflict Risk

It proactively disambiguates against the nearest neighbors: 'not for analyzing or running TLA+/TLC itself' and 'use the quint-modeling skill, which owns that workflow'. Clear niche with distinct triggers and minimal conflict risk — matches the 5 anchor; without these boundary sentences it would risk 3-4 overlap with a sibling Quint skill.

5 / 5

Total

20

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (564 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

crocoder-dev/shared-context-engineering

Path

.agents/skills/quint-lang/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.