CtrlK
BlogDocsLog inGet started
Tessl Logo

visual-brief

Publish substantial implementation, investigation, review, or design reports on a local structured HTML page. Use after meaningful work that benefits from layered detail, or when the human explicitly asks for a visual brief. Skip trivial updates, quick answers, tiny fixes, and routine status messages.

68

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 well-structured, executable skill body that gives concrete commands and a complete payload model with real validation steps. The main improvement space is tightening a few prose sentences and possibly extracting the payload schema into a reference file.

Suggestions

Convert the publish/watch/answer flow into a short numbered checklist with the validation checkpoint (run `visual-brief lint`, fix warnings) stated as an explicit step before sharing the URL.

Trim declarative restatements like 'The human reads the page. The chat only points to it.' that re-explain the section heading.

Consider moving the full JSON payload schema and `trust` enum into a references/ file so SKILL.md stays a lean overview with a one-level pointer.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no padding about concepts Claude already knows; a few declarative sentences ('The human reads the page. The chat only points to it.') could be trimmed, so it is efficient rather than perfectly lean.

4 / 5

Actionability

It provides copy-paste-ready CLI commands (new, serve, publish, fold, answer, lint) and a complete JSON payload example with field-by-field definitions, fully covering the common publish workflow.

5 / 5

Workflow Clarity

The end-to-end flow is laid out in sequenced sections (acknowledge, create/serve, publish, watch, fold/answer, handoff, checks) with explicit validation (lint, render-before-replace, rollback on failure), but it is not presented as a tight numbered checklist with error-recovery tied to each step.

4 / 5

Progressive Disclosure

No bundle files exist; the skill is a single well-organized file with clear section headers and no nested references, which is good structure, though at over 50 lines the inline payload schema could arguably live in a separate reference.

4 / 5

Total

17

/

20

Passed

Description

82%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 strong description that clearly states both capability and trigger conditions with concrete boundary guidance. Specificity is the only soft spot, since it bundles the work into a single 'publish' action rather than naming several distinct operations.

DimensionReasoningScore

Specificity

It names the domain ('local structured HTML page') and one concrete action ('Publish ... reports') plus report categories, but does not enumerate multiple distinct actions, so it sits at 'domain + 1-2 actions' rather than the comprehensive 4/5 anchors.

3 / 5

Completeness

It explicitly answers 'what' ('Publish substantial ... reports on a local structured HTML page') and 'when' ('Use after meaningful work ... or when the human explicitly asks for a visual brief') with a concrete trigger phrase.

5 / 5

Trigger Term Quality

Natural trigger terms are present and explicit ('visual brief', 'implementation, investigation, review, or design reports'), giving good coverage of phrases a user might say, though synonyms are limited rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The 'visual brief' niche and the explicit skip list ('Skip trivial updates, quick answers, tiny fixes, and routine status messages') give it a distinct trigger profile with minimal overlap risk.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pchalasani/claude-code-tools
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.