CtrlK
BlogDocsLog inGet started
Tessl Logo

asset-librarian

Skill para inventariar e organizar imagens, icones, logos, fontes, tokens visuais e referencias graficas do projeto. Use quando precisar mapear assets existentes, evitar inconsistencias visuais e apoiar UI/UX, Frontend e Image Generator.

55

Quality

44%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/19-asset-librarian/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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 adequately communicates its purpose as a visual asset inventory and organization skill, with a clear 'Use when' clause that addresses both what it does and when to use it. Its main weaknesses are moderate specificity in the actions it performs and some overlap risk with other UI/UX or frontend-related skills. Adding more concrete actions and natural user trigger terms would strengthen it.

Suggestions

Add more specific concrete actions beyond 'inventariar e organizar', such as 'catalogar assets por categoria', 'detectar duplicatas', 'gerar relatório de assets utilizados vs não utilizados'.

Include additional natural trigger terms and file type references users might mention, such as 'design system', 'brand assets', '.svg', '.png', 'asset library', 'style guide'.

DimensionReasoningScore

Specificity

The description names the domain (visual assets inventory) and lists types of assets (images, icons, logos, fonts, visual tokens, graphic references), but the actions are somewhat vague — 'inventariar e organizar' (inventory and organize) and 'mapear assets existentes' (map existing assets) are general rather than listing multiple concrete distinct operations.

2 / 3

Completeness

The description clearly answers both 'what' (inventory and organize images, icons, logos, fonts, visual tokens, and graphic references) and 'when' (explicitly states 'Use quando precisar mapear assets existentes, evitar inconsistencias visuais e apoiar UI/UX, Frontend e Image Generator'), providing explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes relevant keywords like 'imagens', 'icones', 'logos', 'fontes', 'tokens visuais', 'UI/UX', 'Frontend', and 'Image Generator', which are useful trigger terms. However, it misses common variations and natural user phrasings (e.g., 'design system', 'brand assets', 'style guide', 'asset library', file extensions like .svg, .png).

2 / 3

Distinctiveness Conflict Risk

The focus on inventorying and organizing visual assets is fairly specific, but terms like 'UI/UX', 'Frontend', and 'Image Generator' could overlap with other design or frontend skills. The mention of supporting other skills helps clarify its role but also introduces potential confusion about boundaries.

2 / 3

Total

9

/

12

Passed

Implementation

22%

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

This skill reads as a high-level specification or checklist rather than an actionable guide. It clearly defines scope (when to use, when not to use) and expected outputs, but completely lacks concrete steps, commands, or examples for how to actually perform the asset inventory. Claude would need to infer the entire workflow from the abstract descriptions, which defeats the purpose of a skill file.

Suggestions

Add a concrete step-by-step workflow: e.g., 1) Scan common asset directories (list them), 2) Catalog each asset type with specific attributes to capture, 3) Generate the inventory markdown, 4) Validate completeness against a checklist.

Provide an example of what the output `docs/repo-audit/assets.md` should look like—even a minimal template inline—so Claude knows the expected format and level of detail.

Include concrete commands or code snippets for discovering assets (e.g., `find . -name '*.svg'`, `grep -r 'font-family'`, or how to extract design tokens from common config files).

Add a validation step: after generating the inventory, verify that all directories were scanned and flag any assets that couldn't be categorized.

DimensionReasoningScore

Conciseness

The skill is relatively brief but includes some sections that are somewhat redundant or could be tightened (e.g., 'Quando Usar' vs 'Quando Nao Usar' overlap, governance references are boilerplate). The 'Entradas Esperadas' section restates what's already implied by the skill description.

2 / 3

Actionability

The skill provides no concrete commands, code, scripts, or executable steps. It describes what should be inventoried and where to persist results, but never shows how to actually scan directories, extract token values, or generate the inventory file. It reads as a checklist of expectations rather than actionable instructions.

1 / 3

Workflow Clarity

There is no sequenced workflow—no numbered steps, no validation checkpoints, no feedback loops. The skill lists inputs, outputs, and content categories but never describes the process of going from repository scan to completed inventory. For a task involving file system traversal and document generation, this lack of process guidance is a significant gap.

1 / 3

Progressive Disclosure

The skill references external policies and a template (`templates/asset-inventory.md`) which is good progressive disclosure, and the sections are well-organized. However, the references are not clearly signaled with links (no markdown links), and it's unclear what those external files actually contain or how they help. The content itself is thin enough that it doesn't need splitting, but the references feel like placeholders rather than well-signaled navigation.

2 / 3

Total

6

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.