scienceworld-liquid-source-finder

This skill searches rooms for a liquid source (e.g., sink, toilet, jug) by sequentially surveying different locations. It should be triggered when the task requires obtaining a liquid (like water) and the agent does not have immediate access to it. The skill involves teleporting to candidate rooms, looking around, and identifying potential sources, guiding the agent toward the nearest available liquid.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./experiments/src/skills/scienceworld/scienceworld-liquid-source-find/SKILL.md

Quality

Content

71%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 clear, actionable, instruction-only skill body with a well-sequenced procedure and concrete game commands. Its main weakness is progressive disclosure: two reference files exist but are not linked from the body, and their content is partly duplicated inline.

Suggestions

Add explicit links to the bundle files where the detail lives, e.g. 'For full action syntax see [action_glossary.md](references/action_glossary.md)' and 'For room likelihood tiers see [room_priority.md](references/room_priority.md)'.

Trim the inline room-priority list in step 2 to the top candidates and defer the full tiered ranking to room_priority.md to remove duplication.

Add a short feedback loop for the failure case (no liquid found in any surveyed room) to give the workflow an explicit error-recovery checkpoint.

Dimension	Reasoning	Score
Conciseness	Mostly lean and well-organized with no over-explanation of concepts Claude already knows; the only trimming opportunity is the Quick Reference block, which restates Trigger/Action Loop/Success already covered in the procedure.	4 / 5
Actionability	Concrete backtick-quoted game commands (`look around`, `pick up`, `move`, `activate`, `deactivate`) and a prioritized room list give mostly executable guidance; the exact `teleport to LOC` syntax lives only in the reference file rather than inline, a minor gap.	4 / 5
Workflow Clarity	A clear five-step sequence with sub-steps for obtaining liquid and an explicit termination/success checkpoint ('Once the required liquid is successfully obtained and in your inventory'); no error-recovery feedback loop for the case where no room yields a liquid.	4 / 5
Progressive Disclosure	The body is well-sectioned but never links to the provided bundle files (references/action_glossary.md, references/room_priority.md), and room-priority content is duplicated inline rather than offloaded to room_priority.md, so references are present but not clearly signaled.	3 / 5
	Total	15 / 20 Passed

Description

87%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 well-constructed description that explicitly answers both what and when with concrete, domain-specific trigger terms and low conflict risk. It could nudge specificity to full coverage by mentioning the obtain/collect actions rather than only the survey actions.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('sequentially surveying different locations', 'teleporting to candidate rooms, looking around, and identifying potential sources') but omits the collection mechanics (move/activate/pick up), leaving minor coverage gaps.	4 / 5
Completeness	Clearly states what it does (searches rooms for a liquid source by surveying locations) and an explicit trigger ('It should be triggered when the task requires obtaining a liquid... and the agent does not have immediate access to it').	5 / 5
Trigger Term Quality	Good natural keyword coverage ('liquid source', 'sink, toilet, jug', 'obtaining a liquid (like water)') but a few common variations a user might say ('get water', 'find water') are absent.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (ScienceWorld room-by-room liquid source retrieval) with distinctive triggers (sink/toilet/jug, obtaining a liquid) and minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: zjunlp/SkillNet
Path: experiments/src/skills/scienceworld/scienceworld-liquid-source-find/SKILL.md
Commit: 076c6df

Reviewed: 6 days 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.