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
44%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/19-asset-librarian/SKILL.mdQuality
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 covers both what the skill does and when to use it, with a clear 'Use when' clause. Its main weaknesses are moderate specificity in the actions described (mostly 'inventory and organize') and some potential overlap with broader UI/UX or frontend skills. Adding more concrete actions and additional natural 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 variations users might mention, such as 'design system', 'brand assets', '.svg', '.png', 'style guide', 'asset library'.
| Dimension | Reasoning | Score |
|---|---|---|
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 terms like 'imagens', 'icones', 'logos', 'fontes', 'tokens visuais', 'assets', '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', 'visual inventory', file extensions like .svg, .png). | 2 / 3 |
Distinctiveness Conflict Risk | The focus on inventorying and organizing visual assets is somewhat distinctive, but the mention of supporting 'UI/UX, Frontend e Image Generator' could cause overlap with skills focused on those broader domains. The scope of 'imagens' and 'icones' could also conflict with image generation or UI component skills. | 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 more like a specification or requirements document than an actionable skill. It clearly defines scope, inputs, outputs, and persistence, but critically lacks any concrete workflow steps, commands, or examples showing Claude how to actually perform the asset inventory. The absence of a sequenced process and executable guidance significantly limits its utility.
Suggestions
Add a step-by-step workflow (e.g., 1. Scan directory tree for image/font/icon files, 2. Extract design tokens from config files, 3. Generate inventory markdown, 4. Validate completeness) with specific commands or code snippets for each step.
Include a concrete example of what the output `docs/repo-audit/assets.md` should look like, even a minimal template inline, so Claude knows the exact format to produce.
Add specific file patterns or commands to discover assets (e.g., `find . -name '*.svg' -o -name '*.png'`, or how to parse design token files like `tokens.json` or `tailwind.config.js`).
Include a validation checkpoint after inventory generation (e.g., verify all referenced assets exist, check for orphaned files) to ensure completeness before marking the task done.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is relatively brief but includes some sections that are somewhat redundant or could be tightened (e.g., 'Quando Usar' and 'Quando Nao Usar' overlap with the description, and 'Governanca Global' just lists policy files without adding actionable value). Not egregiously verbose but not maximally lean either. | 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 a repo for assets, generate the inventory file, or produce the output. 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 inputs to outputs in any ordered fashion. | 1 / 3 |
Progressive Disclosure | The skill references external policies and a template (`templates/asset-inventory.md`), which is good for progressive disclosure. However, the references are scattered across sections without clear signaling of what each contains, and the main content itself lacks a quick-start or overview section that would aid 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
e9f6648
Table of Contents
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.