CtrlK
BlogDocsLog inGet started
Tessl Logo

scienceworld-instruction-reader

Reads a recipe or note from the inventory using the 'read' action and extracts key information. Use this skill when you have acquired a recipe, note, or readable document in your inventory and need to extract explicit instructions, ingredient lists, or procedural steps before executing a task.

70

Quality

88%

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

92%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 lean, highly actionable skill body with an unambiguous workflow and a complete worked example — everything inline earns its tokens. The single notable gap is navigation: the bundled references/action_primer.md, which lists the actions needed for the workflow's final planning step, is never referenced from SKILL.md, leaving a relevant one-level-deep reference undiscoverable.

Suggestions

In the 'Plan Next Actions' step, add a pointer to the bundled reference, e.g. "Common companion actions (mix, pour, focus on, teleport) are listed in references/action_primer.md" — this converts the unsignaled reference into a well-signaled one-level-deep link.

Optionally mention the action primer in the Example's final step ('Proceed to fetch sodium chloride, water, and glass jar, then mix') so the reader knows where to find the exact action syntax before executing.

If the primer is intentionally out of scope for this skill, remove it from the bundle or retitle it so the skill body and bundle structure stay consistent.

DimensionReasoningScore

Conciseness

The ~28-line body is lean with no padding and no explanation of concepts Claude already knows — every section (Purpose, When to Use, Core Workflow, Example) earns its place. Anti-drift check: not a 4, since there is no over-explanation to trim; the brief Purpose line and the e.g.-clauses ('mixing chemicals, assembling components') each carry information.

5 / 5

Actionability

Fully concrete and executable for this environment: the exact command syntax "`read OBJ`" is given, and the worked example shows real commands ("`pick up recipe`", "`read recipe in inventory`") with expected output ('To make salt water, mix sodium chloride and water in a glass jar.') and the extracted goal/components/procedure. Specific examples cover the common case, matching the top anchor.

5 / 5

Workflow Clarity

The three-step sequence (read the document → extract goal/components/procedure → plan next actions) is clear and unambiguous, and the example walks the full flow end-to-end. This is a simple, non-destructive, non-batch skill so the simple-skill exception applies; it is not a 4 because the single workflow has no meaningful validation gap for a read-only extraction task.

5 / 5

Progressive Disclosure

The body itself is well organized into short sections, but the bundle contains references/action_primer.md — a file of common companion actions explicitly written 'to be used in conjunction with the scienceworld-instruction-reader skill' — and the body never mentions or links it, even though step 3 ('determine which skills and actions to invoke next') is exactly where those actions live. This matches the anchor 'references present but not clearly signaled'. Not a 2 because the inline content is appropriate in size and well-sectioned with no nesting; not a 4 because a provided reference is completely unsignaled from the body.

3 / 5

Total

18

/

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 that clearly states both what the skill does and when to use it, with an explicit and well-phrased trigger clause and good natural keywords. The main weakness is the what-clause, which relies on the generic phrase "extracts key information" rather than enumerating the specific extraction capabilities (instructions, ingredient lists, procedural steps) that already appear in the trigger clause.

DimensionReasoningScore

Specificity

The what-clause names the domain and 1-2 concrete actions — "Reads a recipe or note from the inventory using the 'read' action" and "extracts key information" — but "extracts key information" is generic and the enumeration of instruction/ingredient/steps appears only in the trigger clause, matching the '1-2 concrete actions, not comprehensive' anchor. It is not a 4 because the capability list itself does not enumerate several distinct specific actions.

3 / 5

Completeness

Explicitly answers both: what — "Reads a recipe or note from the inventory using the 'read' action and extracts key information"; when — "Use this skill when you have acquired a recipe, note, or readable document in your inventory and need to extract explicit instructions, ingredient lists, or procedural steps before executing a task". The when-clause is explicit with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "recipe", "note", "readable document", "instructions", "ingredient lists", "procedural steps", "inventory" — phrases a user would naturally say. Not a 5 because common synonyms in this domain (e.g., "letter", "book", "manual", "read the instructions") are missing; not a 3 because multiple natural terms and variations are present rather than a single domain keyword.

4 / 5

Distinctiveness Conflict Risk

The inventory/recipe/'read' action niche is mostly distinct from other document skills, with "recipe, note, or readable document in your inventory" tying triggers to a specific context. Not a 5 because terms like "instructions" and "extract explicit instructions" carry minor overlap risk with generic document-reading skills; not a 3 because the inventory-and-readable-document framing is considerably more specific than "Works with document files".

4 / 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
zjunlp/SkillNet
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.