file-tools
Simple shell utilities for files and archives.
39
36%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./examples/skillrun/skills/file_tools/SKILL.mdQuality
Discovery
0%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 description is far too vague to be useful for skill selection. It fails to specify concrete actions, lacks natural trigger terms users would use, provides no guidance on when to select this skill, and is generic enough to conflict with many other skills.
Suggestions
List specific concrete actions the skill performs, e.g., 'Compress, extract, and manage archive files (zip, tar, gzip). Rename, move, copy, and batch-process files using shell commands.'
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to zip, unzip, tar, compress, extract archives, or perform bulk file operations from the command line.'
Narrow the scope to distinguish from other file-handling skills — specify the exact file types (e.g., .zip, .tar.gz, .7z) and operations (e.g., compression, extraction, listing contents) this skill covers.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description is extremely vague — 'simple shell utilities' and 'files and archives' are abstract terms that don't describe any concrete actions like extracting, compressing, renaming, or searching. | 1 / 3 |
Completeness | The description barely addresses 'what' (vaguely mentions shell utilities for files/archives) and completely omits 'when' — there is no 'Use when...' clause or any explicit trigger guidance. | 1 / 3 |
Trigger Term Quality | The terms 'shell utilities', 'files', and 'archives' are overly generic. Users would more naturally say things like 'zip', 'tar', 'compress', 'extract', 'unzip', 'rename files', etc. None of these natural trigger terms are present. | 1 / 3 |
Distinctiveness Conflict Risk | 'Files' is extremely broad and would conflict with nearly any file-related skill. 'Shell utilities' is also generic enough to overlap with many command-line or scripting skills. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a simple, well-structured skill that is concise and easy to follow. Its main weakness is the reference to `scripts/write_sample.sh` without providing the script or confirming its existence in the bundle, which undermines full actionability. Adding a brief verification step after key operations would also improve workflow clarity.
Suggestions
Include the contents of `scripts/write_sample.sh` either inline or as a bundle file so the skill is fully self-contained and executable.
Add a verification step after archiving, e.g., `tar -tzf out/sample.tgz` to confirm the archive contents.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It doesn't explain what shell commands are or how tar works. Every line serves a purpose—commands are listed directly without unnecessary preamble. | 3 / 3 |
Actionability | Commands are concrete and copy-paste ready, but the skill references `scripts/write_sample.sh` without providing its content or showing what it does. There's no bundle file to verify this script exists, making step 2 not fully executable as presented. | 2 / 3 |
Workflow Clarity | Steps are listed in a logical sequence (list files → write file → archive), but there are no validation checkpoints—e.g., verifying the file was written before archiving, or checking the archive contents. For a simple skill this is mostly adequate, but the lack of any verification step (like `tar -tzf out/sample.tgz`) is a minor gap. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines, the content is well-organized with clear sections (Overview, Examples, Output Files). No external references are needed and the structure is easy to scan. | 3 / 3 |
Total | 10 / 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.
- Repository
- trpc-group/trpc-agent-go
- Commit
b22744d
- 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.