CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sn-image-base

Base-layer skill for the SenseNova-Skills project, providing low-level APIs for image generation, recognition (VLM), and text optimization (LLM). This skill does not preprocess inputs; it only calls backend services and returns results. This skill is not user-facing and is intended for upper-layer skills only.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/sn-image-base/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable tool reference with executable commands, concrete parameter tables, and a verified bundle structure. Its main weakness is redundancy: the same environment-variable resolution and parameter-priority material is repeated across three sections, some of which also duplicates references/api_spec.md.

Suggestions

Consolidate the three repeated env-var resolution tables (sn-image-recognize, sn-text-optimize, and 'Default Parameter Behavior') into a single resolution-order section.

Move the detailed parameter tables that duplicate references/api_spec.md out of SKILL.md, keeping only the per-tool minimal usage examples inline.

Trim the 'Mapping Between base-url and Interface Type' table (the LLM and VLM rows are identical) and the 'VLM vs LLM' table, which restates what the tool sections already say.

DimensionReasoningScore

Conciseness

The env-var resolution chains ("SN_VISION_API_KEY -> SN_CHAT_API_KEY -> SN_API_KEY") are documented three separate times — in the sn-image-recognize table, the sn-text-optimize table, and again in 'Default Parameter Behavior' with added prose ("api_key resolution order (high to low): CLI --api-key > command-specific key..."). Content is dense reference tables rather than padded concept explanation, so it is above anchor 2, but the substantial duplication keeps it below anchor 4.

3 / 5

Actionability

Every tool has copy-paste-ready commands ("python scripts/sn_agent_runner.py sn-image-generate --prompt \"...\"") covering minimal calls, base-url/api-key overrides, and Anthropic-compatible invocations, plus concrete success and failure JSON examples with "status" and "elapsed_seconds". Fully executable and the examples cover the common cases.

5 / 5

Workflow Clarity

Clear sequence from "pip install -r requirements.txt" through per-tool invocations to documented success/failure outputs ("status": "ok" / "status": "failed") that act as verification checkpoints. Not 5 because no explicit error-recovery guidance appears in the body (error handling is deferred to references/api_spec.md); not 3 because each tool is an unambiguous single command and output verification is documented.

4 / 5

Progressive Disclosure

The body signals a real, one-level-deep reference ("See `references/api_spec.md` for details") that exists and is well-organized, and all script paths cited in examples exist under scripts/. Not 5 because SKILL.md duplicates a fair amount of the reference's parameter documentation (the 'Default Parameter Behavior' section restates the per-tool tables), so the split between overview and detail is not clean.

4 / 5

Total

16

/

20

Passed

Description

62%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.

The description clearly communicates the skill's role as a non-user-facing base layer with explicit scope boundaries and clear separation from user-facing skills. Its weaknesses are incomplete capability coverage (image editing is omitted) and minimal trigger phrasing that would help discovery.

Suggestions

Add a 'Use when...' style clause with concrete trigger conditions, e.g. 'Use when an upper-layer skill needs to generate, edit, or analyze images via SenseNova APIs'.

Mention image editing (sn-image-edit), a core tool that is entirely missing from the description.

Include natural synonyms such as 'image recognition', 'describe/analyze images', and 'rewrite or refine text' to improve trigger matching.

DimensionReasoningScore

Specificity

Names the domain and three capability areas ("providing low-level APIs for image generation, recognition (VLM), and text optimization (LLM)") but the actions remain category-level ("it only calls backend services and returns results") rather than concrete operations. Above anchor 2 because multiple capability areas are named; below anchor 4 because there are no specific actions like 'generate images from text prompts' or 'edit images using reference images'.

3 / 5

Completeness

Has a clear 'what' ("low-level APIs for image generation, recognition (VLM), and text optimization (LLM)") and an explicit 'when' statement ("This skill is not user-facing and is intended for upper-layer skills only"). Not 5 because no concrete trigger phrases are given; not 3 because the 'when' is explicitly stated rather than missing or merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ("image generation", "recognition (VLM)", "text optimization (LLM)") but common natural variations are missing: image editing — one of the four tools — is entirely absent from the description, and there are no synonyms such as 'analyze an image' or 'describe an image'. This is 'some relevant keywords but missing common variations' rather than the good coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

Clearly niched to "the SenseNova-Skills project" with an explicit audience gate ("intended for upper-layer skills only"), giving low conflict risk. Not 5 because the broad capability terms 'image generation' and 'text optimization' could still overlap with other image or LLM skills absent distinct trigger phrases; not 3 because the project scoping makes it much more specific than 'somewhat specific'.

4 / 5

Total

14

/

20

Passed

Validation

81%

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

CriteriaDescriptionResult

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-base/SKILL.md

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.