CtrlK
BlogDocsLog inGet started
Tessl Logo

sn-ppt-doctor

Environment diagnostic for the PPT family. Validates sn-image-base, API keys, Node runtime, and optional deps; interactively writes .env for required vars. Runs before sn-ppt-entry; does not modify sn-image-* skills.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

An efficient, actionable, well-structured diagnostic skill body: executable invocation, a clear hard/soft check distinction, and an explicit validate-then-fix feedback loop, with no wasted tokens.

DimensionReasoningScore

Conciseness

The body is lean — bulleted hard/soft checks and short sections with no over-explanation of what .env files, API keys, or Node are; every section earns its place.

3 / 3

Actionability

Provides copy-paste executable commands ("python $SKILL_DIR/ppt_doctor/check_environment.py --non-interactive", "--env-path /custom/.env") plus concrete check targets like "node --version >= 18" and named env vars.

3 / 3

Workflow Clarity

Sequencing is unambiguous — hard checks must pass before sn-ppt-entry, soft checks are warnings only, and there is an explicit error-recovery loop ("On any hard-check failure, enters interactive mode to fill .env").

3 / 3

Progressive Disclosure

A simple single-file skill (~50 lines) with well-organized sections (When to use, Hard checks, Soft checks, Invocation, Output, Does NOT) and no need for external reference docs, which the rubric explicitly allows to score 3.

3 / 3

Total

12

/

12

Passed

Description

85%

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 specific, well-scoped diagnostic description in clean third-person voice that answers both what and when. Its only weak spot is trigger-term quality, which leans on internal skill names over natural user phrasing.

Suggestions

Add a natural-language "Use when…" clause with phrasing users would actually say (e.g., "Use when PPT generation reports a missing-env error, or to verify the PPT environment before first use") rather than relying on internal names like sn-image-base.

Surface a user-facing trigger term such as "PPT environment check" or "PPT setup" in the description so it matches how a user would naturally request this skill.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Validates sn-image-base, API keys, Node runtime, and optional deps", "interactively writes .env for required vars", "does not modify sn-image-* skills" — rather than vague domain labels.

3 / 3

Completeness

It explicitly answers both what ("Validates … interactively writes .env") and when ("Runs before sn-ppt-entry"), which is equivalent explicit trigger guidance rather than an implied or missing when.

3 / 3

Trigger Term Quality

Some natural terms appear ("Environment diagnostic", "PPT family", "API keys"), but the bulk is internal jargon ("sn-image-base", "sn-ppt-entry") and it omits common user phrasings like "PPT setup" or "PPT environment check".

2 / 3

Distinctiveness Conflict Risk

A clear PPT-family diagnostic niche with distinct triggers, and the explicit "does not modify sn-image-* skills" boundary reduces conflict with sibling skills.

3 / 3

Total

11

/

12

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.

Validation13 / 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
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.