writing-hashql-jexpr

HashQL J-Expr syntax for writing queries. Use when writing J-Expr code, using #literal/#struct/#list constructs, understanding function call syntax, or working with HashQL query files (.jsonc).

Quality

92%

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

Quality

Content

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

An excellent reference-style skill body: concise tables and executable examples, a practical Do/Don't list, and clean one-level-deep pointers to real reference files. No redundancy with Claude's existing knowledge and no structural weaknesses.

Dimension	Reasoning	Score
Conciseness	Lean and efficient: tables plus executable jsonc snippets with no padding explaining what JSON or expressions are; every token earns its place and it assumes Claude's competence.	5 / 5
Actionability	Fully executable copy-paste-ready jsonc examples cover the common cases (paths, function calls, labeled args, every data constructor, let/fn/if/comparison) with a Do/Don't section giving concrete rules.	5 / 5
Workflow Clarity	Single-purpose syntax-reference skill with clear section sequencing; no destructive or batch operations so the simple-skill exception applies and the single task is unambiguous.	5 / 5
Progressive Disclosure	Clear overview body with well-signaled one-level-deep references (all four referenced files exist in references/), content appropriately split into syntax-reference, special-forms, data-constructors, and type-dsl files.	5 / 5
	Total	20 / 20 Passed

Description

85%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, specific description that explicitly answers both what the skill does and when to use it, with concrete construct names and a file extension as triggers. Minor gaps in comprehensive action coverage and synonym variety keep specificity and trigger quality just below the top anchor.

Dimension	Reasoning	Score
Specificity	Lists several specific actions — 'writing J-Expr code, using #literal/#struct/#list constructs, understanding function call syntax' — with concrete constructs named, though coverage is not fully comprehensive across all J-Expr capabilities.	4 / 5
Completeness	Clearly states the 'what' (syntax for writing HashQL J-Expr queries) and an explicit 'Use when...' clause with concrete trigger phrases including file extension.	5 / 5
Trigger Term Quality	Includes natural terms users would say ('writing J-Expr code', 'function call syntax', 'HashQL query files (.jsonc)') plus the .jsonc extension, but a few synonyms (e.g. 'HashQL queries', 'jexpr') are only implied via the keyword list rather than the description prose.	4 / 5
Distinctiveness Conflict Risk	'HashQL J-Expr syntax' is a clear narrow niche with distinct construct-level triggers (#literal/#struct/#list) and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	14 / 16 Passed

Repository: hashintel/hash
Path: .claude/skills/writing-hashql-jexpr/SKILL.md
Commit: 0144f9c

Reviewed: 1 day 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.