CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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).

69

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

78%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-structured syntax reference: lean tables and executable snippets in the body, backed by a clearly signaled four-file reference bundle one level deep. The gaps are minor — a duplicated example and unexplained placeholders ('_', 'body_expr') in the fn/let patterns that force a trip to special-forms.md to actually apply them.

Suggestions

Remove the duplicated entity-query snippet from the Examples section (it already appears under Function Calls) to tighten conciseness.

Explain the '_' wildcard and 'body_expr' placeholders inline in the Function Definition and Let Binding patterns, or explicitly defer to references/special-forms.md at those points so the examples are self-contained.

Add a one-line pointer under Common Patterns naming which reference file documents each construct (e.g. special-forms.md for if/let/fn) so readers know where to find full argument layouts.

DimensionReasoningScore

Conciseness

Mostly lean — compact tables and targeted jsonc snippets with no padding and no explanation of concepts Claude already knows. Minor trimmable duplication keeps it below 5: the entity-query snippet appears verbatim in both Function Calls and Examples, and the Expression Types table is repeated in references/syntax-reference.md.

4 / 5

Actionability

Concrete, executable jsonc snippets cover literals, structs, lists, tuples, dicts, calls, let, fn, if, and comparisons. Below 5 because the Function Definition and Let Binding patterns use unexplained placeholders ('_', 'body_expr') that are not executable as written.

4 / 5

Workflow Clarity

Clear organization — expression types, then each construct, then Common Patterns, Do/Don't, and Examples, with a References section for deeper detail. Below 5 because elements like the '_' wildcard and the fn argument structure are left implicit rather than explained or validated inline.

4 / 5

Progressive Disclosure

The body is a concise overview and all four bundle files (syntax-reference.md, special-forms.md, data-constructors.md, type-dsl.md) exist, are clearly signaled with one-line descriptions in the References section, and are one level deep (siblings cross-link, no nesting). Parser source paths add useful navigation; content is appropriately split.

5 / 5

Total

17

/

20

Passed

Description

90%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 with an explicit 'Use when...' clause, concrete trigger phrases, the .jsonc file extension, and highly distinctive niche terminology. The only weakness is a thin capability statement — the concrete constructs live in the trigger clause rather than a list of what the skill does.

DimensionReasoningScore

Specificity

The what-clause is a single capability statement ('HashQL J-Expr syntax for writing queries'); the concrete items (#literal/#struct/#list constructs, function call syntax) appear only as triggers in the when-clause rather than as an enumerated list of actions. This matches the 'names domain and 1-2 concrete actions' anchor — not 4, since no several distinct actions are listed, and not 2, since the domain and constructs are named concretely.

3 / 5

Completeness

Explicitly answers both what ('HashQL J-Expr syntax for writing queries') and when ('Use when writing J-Expr code, ... or working with HashQL query files (.jsonc)') with concrete trigger phrases. Matches the anchor-5 example structure exactly; the when-clause is explicit and specific, so 4 does not fit.

5 / 5

Trigger Term Quality

Natural terms a HashQL user would say are comprehensively covered: 'writing J-Expr code', 'using #literal/#struct/#list constructs', 'understanding function call syntax', 'working with HashQL query files (.jsonc)', including the file extension. No natural synonym for this niche is missing.

5 / 5

Distinctiveness Conflict Risk

'HashQL' and 'J-Expr' are highly specific niche terms with distinct triggers; there is virtually no overlap risk with other skills. Clear niche with minimal conflict risk, matching the 5 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

hashintel/hash

Path

.agents/skills/writing-hashql-jexpr/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.