CtrlK
BlogDocsLog inGet started
Tessl Logo

visual-recap

Turn a PR, branch, commit, or git diff into an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review notes.

59

Quality

74%

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 ./.agents/plugins/agent-native-visual-plans/skills/visual-recap/SKILL.md

The canonical home for this skill is visual-recap in BuilderIO/skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%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, highly actionable instruction-only skill with concrete commands, explicit block schemas, budgets, and validation checkpoints. Its main weaknesses are length and repetition across overlapping sections, plus detail that could be moved to the existing reference files. Consolidating the wireframe/URL rules and moving peripheral sections into references would lift both conciseness and progressive disclosure.

Suggestions

Consolidate the repeated wireframe-quality and before/after guidance (currently spread over 'UI Impact Needs Wireframes', 'Wireframe Quality', and 'Before/After Is The Headline') into the single wireframe reference and keep only pointers inline.

Move the detailed URL-resolution rules and the bidirectional feedback loop into references/connection.md or a dedicated reference, keeping a short inline summary.

Add one compact end-to-end numbered workflow (collect diff → fetch block catalog → author → validate with plan local check → publish → report URL) near the top so the sequence is explicit.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, skill-specific rules and mostly earns its tokens, but it is roughly 550 lines with noticeable repetition: the never-inline rule, the localhost-origin mismatch, before/after layout guidance, and wireframe quality rules are each restated across multiple sections. It is not a 2 — the padding is duplicated rules rather than generic explanations of things Claude already knows — but it could clearly be tightened.

3 / 5

Actionability

Concrete commands ('npx @agent-native/core@latest plan local serve --dir <plan-dir> --kind recap --open', 'plan blocks --out plan-blocks.md', 'plan local check'), explicit prop schemas (change flags, mode: 'split', annotations anchored to AFTER-side line numbers), and numeric budgets (3-8 tabs, ~150 lines per tab, ~70-char titles) make the guidance highly executable. It stops short of a 5 because MDX authoring forms are not shown inline; they are delegated to the get-plan-blocks catalog, leaving a few concrete examples to fetch at runtime.

4 / 5

Workflow Clarity

The canonical shape skeleton (headline → narrative → data-model/api-endpoint → file-tree → Key changes tabs) gives a clear sequence, and validation checkpoints are explicit: 'plan local check' before reporting, a bounded one-render-one-fix inspection loop, and 'plan local verify'. It is not a 5 because the end-to-end flow is spread across thematic sections rather than one sequenced workflow with an ordered collect→author→validate→report procedure.

4 / 5

Progressive Disclosure

References are real files, one level deep, and strongly signaled ('READ references/wireframe.md ... it is the single source of truth'), with the cross-skill canvas reference also explicitly named. Structure is good, but a substantial amount of detail (URL resolution rules, the bidirectional loop, security gating) is inlined in SKILL.md that could live in reference files, so the split is not fully appropriate as the 5 anchor requires.

4 / 5

Total

15

/

20

Passed

Description

71%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 specific, well-scoped description with concrete inputs and outputs and good natural trigger terms. Its main weakness is the absence of any explicit 'use when' trigger guidance, which caps completeness. Adding a sentence such as 'Use when reviewing a large PR or branch, or when asked to summarize what changed' would raise it to the top band.

Suggestions

Append an explicit trigger clause, e.g. 'Use when reviewing a large PR/branch or when asked to summarize what changed in a commit.'

Include common user phrasings as trigger synonyms, such as 'summarize this PR', 'what changed', or 'review notes'.

Briefly distinguish the recap (reverse, post-hoc) from the sibling forward-planning skill to reduce overlap-trigger risk.

DimensionReasoningScore

Specificity

The description lists multiple concrete deliverables — 'an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review notes' — and names concrete inputs (PR, branch, commit, git diff). Coverage of what the skill produces is comprehensive; it is not below the 5 anchor since no output type is missing and none of the phrasing is generic.

5 / 5

Completeness

The 'what' is explicit and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description — the 'when' is only weakly implied by naming the inputs. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms like 'PR', 'branch', 'commit', 'git diff', 'diagrams', 'annotated diffs', and 'review notes' cover what a user would plausibly say. It misses common synonyms a user might naturally use, such as 'summarize this PR', 'what changed', or 'changelog', so it falls between the 4 anchor (good coverage, a few terms missing) and the 5 anchor (synonyms and extensions) rather than clearly matching either.

4 / 5

Distinctiveness Conflict Risk

The git-diff-to-visual-recap niche is clearly distinct from unrelated skills, with specific trigger terms. There is minor overlap risk with a closely related forward-planning skill (visual-plan) that operates on the same block vocabulary, which keeps it from a clear 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (553 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
BuilderIO/agent-native
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.