mining

Where diamonds spawn in Minecraft 1.20.

1.38x

Quality

55%

Does it follow best practices?

Impact

100%

1.38x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./agent-battle/skills/mining/SKILL.md

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, concise skill that efficiently communicates non-obvious Minecraft diamond mining knowledge with specific, actionable details including exact coordinates, block names, tool requirements, and API usage patterns. The main weakness is the lack of an explicit step-by-step workflow structure, which would make the sequential nature of the task clearer. The meta-commentary at the end is mildly unnecessary but doesn't significantly detract.

Suggestions

Restructure the content as a numbered workflow (1. Craft iron pickaxe → 2. Descend to y=-55 → 3. Mine diamond ore → 4. Relocate 30+ blocks) to make the sequence explicit and improve workflow clarity.

Dimension	Reasoning	Score
Conciseness	Every sentence conveys non-obvious, actionable information specific to Minecraft diamond mining. The skill correctly assumes Claude knows basic concepts and doesn't waste tokens explaining what diamonds or pickaxes are in general terms. The parenthetical meta-note at the end is slightly unnecessary but brief enough not to detract.	3 / 3
Actionability	Provides specific y-level (-58), specific block names to search for, exact tool requirements with crafting recipe, concrete API calls (go_near with example JSON), and a relocation strategy with a specific distance threshold (30+ blocks). Highly actionable and directly usable.	3 / 3
Workflow Clarity	The steps are implicitly sequenced (craft pickaxe → descend → mine → relocate) but not explicitly numbered or structured as a workflow. For a task that involves sequential steps with potential failure points (e.g., mining with wrong pickaxe drops nothing), a more explicit sequence with validation checkpoints would improve clarity.	2 / 3
Progressive Disclosure	This is a simple, single-purpose skill under 50 lines with no need for external references. The content is well-organized with bold-highlighted key topics acting as section markers, making it easy to scan and navigate.	3 / 3
	Total	11 / 12 Passed

Description

22%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description reads like a question or search query rather than a skill description. It fails to state what the skill does (no verbs/actions) and provides no guidance on when Claude should select it. While the topic is narrow enough to avoid broad conflicts, the lack of actionable structure makes it a poor skill description.

Suggestions

Rewrite as an action-oriented description, e.g., 'Provides information about diamond ore generation and optimal mining levels in Minecraft 1.20, including Y-level ranges and biome-specific spawn rates.'

Add an explicit 'Use when...' clause with trigger terms, e.g., 'Use when the user asks about diamond mining, ore distribution, best Y level for diamonds, or Minecraft 1.20 resource spawning.'

Broaden trigger term coverage to include natural variations like 'mining', 'ore', 'Y level', 'deepslate diamonds', 'best level to find diamonds'.

Dimension	Reasoning	Score
Specificity	The description names a very narrow topic ('where diamonds spawn') but does not describe any concrete actions the skill performs—it reads more like a search query than a capability description.	1 / 3
Completeness	There is no explicit 'what does this do' action statement and no 'when should Claude use it' clause. Both are missing or extremely weak.	1 / 3
Trigger Term Quality	It includes natural keywords a user might say ('diamonds', 'spawn', 'Minecraft 1.20'), but coverage is narrow—missing variations like 'ore distribution', 'mining', 'Y level', 'deepslate', or 'best level to mine'.	2 / 3
Distinctiveness Conflict Risk	The mention of 'Minecraft 1.20' and 'diamonds spawn' is fairly niche, but it could overlap with any general Minecraft knowledge or gaming FAQ skill since it lacks clear scope boundaries.	2 / 3
	Total	6 / 12 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: anthropics/cwc-workshops
Commit: 970b040

Reviewed: 17 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.