sn-image-doctor

Environment diagnostic skill for SenseNova-Skills project. Checks that sn-image-base is properly installed and configured, validates dependencies and environment variables. Prompts user to configure missing required variables and saves them to .env file. After configuration, reloads environment and suggests agent restart if needed.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/sn-image-doctor/SKILL.md

Quality

Content

85%

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

The body is highly actionable with executable commands and a clear, validated workflow, and it uses progressive disclosure well by delegating logic to the bundled script. Its only real weakness is verbosity — the extensive mock-output blocks and troubleshooting detail exceed what a single-script diagnostic skill strictly needs.

Suggestions

Trim the full mock-output blocks to representative excerpts (a few key lines per state) to reduce token load without losing clarity.

Condense the four troubleshooting subsections, merging the install/dependency/env-var fixes where the commands overlap, to remove redundancy.

Dimension	Reasoning	Score
Conciseness	Largely on-task with concrete commands, but two full mock-output blocks plus a reload-failure block and four troubleshooting subsections are more than a 'run one script' skill needs; the mock outputs and some troubleshooting repetition could be tightened.	2 / 3
Actionability	Fully executable, copy-paste-ready guidance throughout — 'python scripts/check_environment.py --verbose', 'pip install -r skills/sn-image-base/requirements.txt', 'export SN_API_KEY=...', venv setup, and a curl test — with specific examples rather than pseudocode.	3 / 3
Workflow Clarity	The single primary action is unambiguous ('python scripts/check_environment.py'), and the documented flow (check → prompt for missing vars → save to .env → reload → suggest restart on failure) includes an explicit error-recovery feedback loop, satisfying the simple-skill allowance for a 3.	3 / 3
Progressive Disclosure	Implementation is appropriately offloaded to the real scripts/check_environment.py, the body is a well-organized overview, and See Also provides one-level-deep navigation to sn-image-base/SKILL.md, the api_spec, and sn-infographic/SKILL.md, all clearly signaled.	3 / 3
	Total	11 / 12 Passed

Description

67%

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 specific and well-scoped to its project niche, with concrete actions and third-person voice. Its main weakness is the missing explicit 'Use when...' trigger guidance, which caps completeness, and natural trigger terms are confined to the triggers field rather than the description.

Suggestions

Add an explicit 'Use when ...' clause to the description naming natural trigger phrases (e.g. 'Use when running a SenseNova-Skills environment check, health check, or doctor before other skills').

Surface one or two natural user-facing terms ('environment check', 'health check') inside the description body itself, not only in the triggers field, to improve trigger_term_quality.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Checks that sn-image-base is properly installed and configured, validates dependencies and environment variables', 'Prompts user to configure missing required variables and saves them to .env file', 'reloads environment and suggests agent restart' — matching the multiple-specific-actions anchor.	3 / 3
Completeness	Clearly answers WHAT the skill does, but the WHEN is only implied — there is no 'Use when...' clause or equivalent explicit trigger guidance, which the guidelines say caps completeness at 2.	2 / 3
Trigger Term Quality	Contains the relevant keyword 'Environment diagnostic' but lacks the natural trigger variations a user would say ('doctor', 'health check', 'environment check') that live only in the separate triggers field, so coverage is partial.	2 / 3
Distinctiveness Conflict Risk	Scoped to 'SenseNova-Skills project' and 'sn-image-base' specifically, giving it a clear niche unlikely to collide with other skills.	3 / 3
	Total	10 / 12 Passed

Validation

81%

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

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: OpenSenseNova/SenseNova-Skills
Path: skills/sn-image-doctor/SKILL.md
Commit: 179fea1

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