baoyu-compress-image
Compresses images to WebP (default) or PNG with automatic tool selection. Use when user asks to "compress image", "optimize image", "convert to webp", or reduce image file size.
92
93%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that concisely covers what the skill does, when to use it, and includes natural trigger terms. It uses third person voice, specifies concrete formats and actions, and has an explicit 'Use when' clause with multiple natural phrasings users would employ.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists specific concrete actions: compresses images, converts to WebP or PNG, automatic tool selection. Mentions specific formats and a default behavior. | 3 / 3 |
Completeness | Clearly answers both 'what' (compresses images to WebP/PNG with automatic tool selection) and 'when' (explicit 'Use when' clause with specific trigger phrases). | 3 / 3 |
Trigger Term Quality | Includes natural trigger terms users would actually say: 'compress image', 'optimize image', 'convert to webp', 'reduce image file size'. These cover common variations of how users would phrase this request. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to image compression/optimization with specific format mentions (WebP, PNG). Unlikely to conflict with general image editing, resizing, or other file processing skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that provides clear CLI usage with concrete examples and good option documentation. Its main weakness is the lack of error handling guidance and validation steps — particularly around the tool resolution chain (BUN_X and the compression tool fallback) and verifying output quality. The EXTEND.md preference system is cleanly documented.
Suggestions
Add brief error handling guidance: what happens if no compression tool is found, or if BUN_X resolution fails — provide a concrete fallback or error message to expect.
Add a verification step after compression (e.g., check output file exists and size is smaller) to improve workflow robustness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It uses tables for options and preferences, avoids explaining what image compression is, and every section serves a clear purpose. No unnecessary padding or concept explanations. | 3 / 3 |
Actionability | Provides fully executable CLI commands with concrete examples covering single file, directory, format options, and JSON output. The options table is complete with defaults, and expected output format is shown. | 3 / 3 |
Workflow Clarity | The skill is relatively simple (single CLI command), but it lacks validation/verification steps. There's no guidance on what to do if compression fails, no mention of checking output quality, and the tool selection fallback chain (sips → cwebp → ImageMagick → Sharp) has no troubleshooting if none are available. The BUN_X resolution instructions are a multi-step process without clear error handling. | 2 / 3 |
Progressive Disclosure | Content is well-structured with clear sections. References to EXTEND.md for customization are well-signaled with a priority table. The main script is referenced cleanly, and the skill appropriately keeps the overview concise while pointing to extension points. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | 8 / 11 Passed | |
- Repository
- jimliu/baoyu-skills
- Commit
505a7e1
- 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.