CtrlK
BlogDocsLog inGet started
Tessl Logo

explain

Parse and interpret Z3 output for human consumption. Handles models, unsat cores, proofs, statistics, and error messages. Translates solver internals into plain-language explanations.

64

Quality

76%

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 ./.github/skills/explain/SKILL.md
SKILL.md
Quality
Evals
Security

Given raw Z3 output (from the solve, prove, optimize, or benchmark skills), produce a structured explanation. This skill is for cases where the solver output is large, nested, or otherwise difficult to read directly.

Step 1: Identify the output type

Action: Determine the category of Z3 output to explain: model, core, statistics, error, or proof.

Expectation: The output type maps to one of the recognized formats in the table below.

Result: If the type is ambiguous, use --type auto and let the script detect it. Proceed to Step 2.

Output containsExplanation type
(define-fun ...) blocksmodel explanation
unsat core labelsconflict explanation
:key value statisticsperformance breakdown
(error ...)error diagnosis
proof termsproof sketch

Step 2: Run the explainer

Action: Invoke explain.py with the output file or stdin.

Expectation: The script auto-detects the output type and produces a structured plain-language summary.

Result: A formatted explanation is printed. If detection fails, re-run with an explicit --type flag.

python3 scripts/explain.py --file output.txt
python3 scripts/explain.py --stdin < output.txt
python3 scripts/explain.py --file output.txt --debug

Step 3: Interpret the explanation

Action: Review the structured explanation for accuracy and completeness.

Expectation: Models list each variable with its value and sort. Cores list conflicting assertions. Statistics show time and memory breakdowns.

Result: Use the explanation to answer the user query or to guide the next skill invocation.

For models:

  • Each variable is listed with its value and sort
  • Array and function interpretations are expanded
  • Bitvector values are shown in decimal and hex

For unsat cores:

  • The conflicting named assertions are listed
  • A minimal conflict set is highlighted

For statistics:

  • Time breakdown by phase (preprocessing, solving, model construction)
  • Theory solver load distribution
  • Memory high-water mark

Parameters

ParameterTypeRequiredDefaultDescription
filepathnofile containing Z3 output
stdinflagnooffread from stdin
typestringnoautoforce output type: model, core, stats, error
debugflagnooffverbose tracing
dbpathno.z3-agent/z3agent.dblogging database
Repository
Z3Prover/z3
Last updated
First committed

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.