CtrlK
BlogDocsLog inGet started
Tessl Logo

claims-formalization

Elicit or transcribe a target claim and the definitions and supporting claims its justification rests on, maintain a recoverable claims workpiece, prepare statement cards for an external claims ledger, and explain what the ledger's standing does and does not establish. Use for a claim-formalization interview, a mission or milestone proposal, a card faithfulness review, or a question about what is established.

60

Quality

69%

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 ./libs/@hashintel/brunch-agent/packages/plugin-claims/src/skills/claims-formalization/SKILL.md
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.

The body is a lean, well-sequenced process specification: a clear lifecycle, three cleanly separated runtime branches, and disciplined pointers to one-level-deep reference files, with no token waste on concepts Claude already knows. Its main gap is that all concrete examples of the artifacts (claims, cards, workpiece entries) live in the references, leaving the body's guidance procedurally precise but example-free, and one referenced template (templates/workpiece.md) is absent from the bundle.

Suggestions

actionability: Include one minimal inline example in the body — a single settled claim with its origin, hypotheses, dependencies, and intended card status — so the workpiece shape is actionable without opening a reference file.

actionability: Add a short worked example of one statement card (or one explicit before/after of workpiece meaning to card fields) to anchor the "translate only settled workpiece meaning into card fields" instruction.

progressive_disclosure: Ensure `templates/workpiece.md` ships in the bundle (or inline its recording shape), since the body instructs reading it "when creating or materially revising the claims account" but the file is not present alongside the references.

DimensionReasoningScore

Conciseness

The ~50-line body is dense with instruction and contains no filler and no explanations of concepts Claude already knows; every sentence carries procedural weight (e.g. "A card drafted in prose is not a settled workpiece, and a settled workpiece is not a submitted card"). It falls short of the 5 anchor because of minor repetition — the "person's and the source's vocabulary" point and repeated pointers to cards-and-standing.md could be trimmed — but is well above the 3 anchor's "some unnecessary explanation".

4 / 5

Actionability

Guidance is procedurally concrete — "Settle the current account with `mutate_workpiece` before preparing cards", branch-specific read orders, "Do not interview", and explicit delivery-state accounting — but the body gives no example of what a claim, card, or workpiece entry actually looks like; the concrete shapes live entirely in the references. For an instruction-only skill this matches the 3 anchor (concrete but incomplete, missing key details in-body) rather than 4, and it is clearly above 2, which expects only high-level hints.

3 / 5

Workflow Clarity

The lifecycle is clearly sequenced (orient → elicit or transcribe → maintain the workpiece → prepare cards → check and deliver) with three well-separated runtime branches and explicit checkpoints: "do not claim an unavailable check occurred", gap reporting with "the smallest question a later interactive conversation must answer", and the immutable-card revision rule. It misses the 5 anchor because the actual check content is delegated to a reference file rather than stated as an explicit validate-fix-retry loop in the body.

4 / 5

Progressive Disclosure

References are one level deep, each signalled with its exact path and the task that should trigger reading it (e.g. "Read `references/cards-and-standing.md` before drafting, reviewing, or delivering card text"), and both referenced files exist with substantial content that points no deeper. It falls short of 5 because `templates/workpiece.md` is referenced repeatedly but is not present in this bundle, and the `/.flue/packaged-skills/...` path guidance is opaque without the activation briefing it defers to.

4 / 5

Total

15

/

20

Passed

Description

71%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 well-constructed: it states four concrete capabilities and closes with an explicit "Use for…" trigger clause covering four distinct use cases, making it clearly distinguishable from other skills. Its main weakness is vocabulary — terms like "claims workpiece", "statement cards", and "card faithfulness review" are internal to the domain, so the natural keywords a user would actually say are largely missing.

Suggestions

trigger_term_quality: Add plain-language synonyms to the trigger clause, e.g. "Use when the user asks to formalize a claim, break a claim into supporting claims or definitions, run a claims interview, or check what a claims ledger actually proves".

trigger_term_quality: Include the everyday phrasings a user would naturally type ("is this claim established?", "write cards for the ledger", "interview me about this claim") alongside the domain-internal ones.

specificity: Briefly gloss the internal artifacts on first mention (e.g. "statement cards (ledger-ready claim records)") so the concrete actions read concretely to readers outside this domain.

DimensionReasoningScore

Specificity

The description lists four distinct concrete actions — "Elicit or transcribe a target claim", "maintain a recoverable claims workpiece", "prepare statement cards for an external claims ledger", and "explain what the ledger's standing does and does not establish" — giving several specific actions with only minor coverage gaps. It falls short of the 5 anchor because the internal vocabulary ("claims workpiece", "statement cards") makes the actions read less concretely to an outside user, and above the 3 anchor because coverage is broad rather than just 1-2 actions.

4 / 5

Completeness

Both questions are answered: the what is a multi-action capability statement and the when is an explicit "Use for…" clause naming four concrete triggers. It sits between the 4 and 5 anchors — both are present and explicit, but the when-clause relies on internal vocabulary rather than plainly concrete trigger phrases, keeping it below the 5 example.

4 / 5

Trigger Term Quality

"Use for a claim-formalization interview, a mission or milestone proposal, a card faithfulness review, or a question about what is established" provides some relevant trigger phrases, but they are domain-internal formulations rather than the natural synonyms and variations a user would typically say. It matches the 3 anchor (some relevant keywords, missing common variations) rather than 4, which expects good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — claims formalization, ledger statement cards, card faithfulness review — with triggers that would not plausibly fire for any generic skill. It matches the 5 anchor (clear niche with distinct triggers, minimal conflict risk) and is well above the 4 anchor's "minor overlap risk with closely related skills".

5 / 5

Total

16

/

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