CtrlK
BlogDocsLog inGet started
Tessl Logo

sdcpn-modelling

Elicit or revise an operational process model, maintain its recoverable workpiece, and construct a checked SDCPN when Petrinaut capabilities are available. Use for a process-modelling interview, Petri net, or analysis or revision of either artifact.

66

Quality

80%

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-sdcpn/src/skills/sdcpn-modelling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 disciplined, dense instruction-only skill: the multi-step lifecycle is clearly sequenced with built-in validation and feedback loops, and detail is appropriately pushed into four real one-level references. Weaknesses are compressed-to-opaque phrasing, two abstract steps, and a dangling templates/workpiece.md reference missing from the bundle.

Suggestions

Ship or fix the missing 'templates/workpiece.md' — the body references it twice but it does not exist in the bundle, which will dead-end the model at exactly the moment it needs the recording shape.

Add one short worked example (a settled workpiece line or a Changed-disposition application) to ground the abstract 'Orient' and disposition language.

Simplify the doubly-negated authorization sentences (e.g. the 'labelling an unsupported default' clause) into a direct rule; the same constraint can be said once in half the tokens.

DimensionReasoningScore

Conciseness

The body explains nothing Claude already knows and defers all domain detail to references; nearly every token is directive. It falls short of anchor 5 because several sentences are convoluted or redundant ('Labelling an unsupported operational default as an assumption does not authorize using it when that authorization is absent') and could be tightened without loss, but it is well above anchor 3's unnecessary-explanation level.

4 / 5

Actionability

Concrete, executable directives dominate: which file to read before which action ('Read references/pn-construction.md and references/checks.md before beginning'), named tools ('mutate_workpiece', mounted Petrinaut tools), a three-way disposition rule (Changed/Already represented/Blocked), and explicit authorization conditions. Gaps keep it from anchor 5: 'Orient' and 'Elicit or revise' remain fairly abstract, and no concrete example of a workpiece entry or net fragment appears anywhere in the body.

4 / 5

Workflow Clarity

The lifecycle is explicitly sequenced (Before substantive work → Orient → Elicit or revise → Maintain the workpiece → Construct → Check and deliver) with the interleaving model stated up front, explicit validation checkpoints ('run references/checks.md' after each net change, 'Apply references/checks.md whenever construction is prepared or attempted'), a feedback loop (Blocked → ask the smallest resolving question or record the gap), and the disposition rules acting as a per-answer checklist. Matches anchor 5; anchor 4 would require missing checkpoints, which are not missing.

5 / 5

Progressive Disclosure

The body is a genuine overview that signals each one-level-deep reference at its exact point of need (profile.md before elicitation, pn-construction.md and checks.md before construction, experiment-configuration.md on decision statements) and explicitly forbids recursive following; the four references exist and do not chain further. It misses anchor 5 because 'templates/workpiece.md' is referenced twice but absent from the bundle, and the resource-discipline instruction (paths only via the activation briefing, relative names as labels) makes navigation less direct than a standard well-signaled reference layout.

4 / 5

Total

17

/

20

Passed

Description

78%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 explicit what and when clauses, distinct niche triggers, and several concrete capability statements. Its main weaknesses are jargon density (SDCPN, Petrinaut, workpiece) and slightly narrow trigger coverage that misses common user phrasings.

Suggestions

Add natural synonyms to the trigger clause, e.g. 'Use when the user mentions a Petri net, process/workflow model, or wants to elicit or revise an operational process'.

Add one more plainly-worded concrete action (e.g. 'check the resulting net for structural and semantic errors') so capabilities read as operations rather than abstract jargon.

Clarify that 'workpiece' means the shared process-model document, or replace the term with plain language in the description.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Elicit or revise an operational process model', 'maintain its recoverable workpiece', 'construct a checked SDCPN' — with minor coverage gaps (e.g., checking/analysis is only implied). It sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive action list), closer to 4; some actions like 'maintain its recoverable workpiece' are abstract jargon rather than a fully concrete operation.

4 / 5

Completeness

Both parts are explicit: 'what' ('Elicit or revise... maintain its recoverable workpiece, and construct a checked SDCPN') and 'when' ('Use for a process-modelling interview, Petri net, or analysis or revision of either artifact'). Not anchor 5 because the 'when' clause is terse and jargon-bound — the conditional 'when Petrinaut capabilities are available' is a capability gate rather than a user trigger, and trigger phrases could be more specific.

4 / 5

Trigger Term Quality

Natural trigger terms are present — 'process-modelling interview', 'Petri net', 'analysis or revision' — and a user needing this skill would plausibly say 'Petri net'. It falls short of anchor 5's comprehensive synonym coverage (missing variations like 'process model', 'workflow model', or tool-specific names alongside the jargon 'SDCPN'/'Petrinaut').

4 / 5

Distinctiveness Conflict Risk

The SDCPN/Petri-net process-modelling niche is clearly staked out with distinct triggers ('process-modelling interview', 'Petri net'); it would not plausibly activate the wrong skill. Matches anchor 5's clear-niche example, and is not the slightly-overlapping anchor 4.

5 / 5

Total

17

/

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.