simplify

Reduce formula complexity using Z3 tactic chains. Supports configurable tactic pipelines for boolean, arithmetic, and bitvector simplification.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/simplify/SKILL.md

Quality

Content

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

The content is well-structured, executable, and concise, with real bundle references and a clear workflow including feedback loops. It lacks an explicit validation step, though the operation is non-destructive so that is a minor gap rather than a cap.

Dimension	Reasoning	Score
Conciseness	The body is lean with terse Action/Expectation/Result blocks and no padding about what Z3 is, though the opening motivation sentence and a restated default-chain note are minor tokens that could be trimmed.	4 / 5
Actionability	Three copy-paste-ready invocations (inline formula, file input, debug) plus a complete parameters table and a tactic reference table give fully executable guidance covering the common cases.	5 / 5
Workflow Clarity	A clear three-step sequence (choose tactics, run, interpret) with feedback loops ('If unchanged, try a different tactic chain'), but no explicit validation checkpoint; this is non-destructive single-formula work so the batch/destructive cap does not apply.	4 / 5
Progressive Disclosure	Well-organized sections with the one bundle reference (scripts/simplify.py) being a real, one-level-deep file; parameters and tactic tables are appropriately inline, with only minor organization gaps.	4 / 5
	Total	17 / 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 is third-person, specific, and uses natural trigger terms, but it omits any explicit 'when to use' guidance, which caps completeness. Adding a 'Use when...' clause and SMT/SMT-LIB synonyms would raise it.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when simplifying SMT formulas, reducing formula size before solving, or debugging Z3 tactic selection.'

Include natural synonyms users say, such as 'SMT', 'SMT-LIB', and '.smt2', not just 'formula' and 'Z3'.

Name a second concrete action (e.g. 'apply', 'compare tactic chains') to broaden the action coverage beyond a single simplify operation.

Dimension	Reasoning	Score
Specificity	Names the domain ("Z3 tactic chains") and concrete actions ("Reduce formula complexity", configurable pipelines for boolean/arithmetic/bitvector), but offers essentially one main action with theory variants rather than multiple distinct actions, matching the '1-2 concrete actions' anchor.	3 / 5
Completeness	The 'what' is clear (reduce formula complexity via Z3 tactic pipelines) but there is no 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 3.	3 / 5
Trigger Term Quality	Natural terms a user would say are present ("formula", "Z3", "simplify", "tactic") plus theory names, but common synonyms like "SMT", "SMT-LIB", and ".smt2" that appear in the body are missing from the description.	4 / 5
Distinctiveness Conflict Risk	The Z3 tactic-simplification niche is specific and mostly distinct, with only minor overlap risk against sibling skills like solve/prove/optimize referenced in the body.	4 / 5
	Total	14 / 20 Passed

Validation

100%

Warnings & errors only

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: Z3Prover/z3
Path: .github/skills/simplify/SKILL.md
Commit: 6aa9416

Reviewed: ~1 hour ago

Table of Contents

Discovery Implementation Validation

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.