file-tools
Simple shell utilities for files and archives.
49
36%
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 ./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 so generic it would conflict with many other skills.
Suggestions
List specific concrete actions the skill performs, e.g., 'Compress and extract archives (zip, tar, gzip), search files with grep/find, rename/move/copy 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 file operations via the command line.'
Narrow the scope to distinguish from other file-related skills, e.g., specify the exact shell utilities covered (tar, zip, find, chmod, etc.) and the types of tasks supported.
| 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 weakly addresses 'what' (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 only potentially useful trigger terms are 'shell', 'files', and 'archives', which are overly generic. Missing natural terms users would say like 'zip', 'tar', 'compress', 'extract', 'unzip', 'rename', 'find', etc. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic — 'files' and 'shell utilities' could overlap with virtually any skill involving command-line operations, file manipulation, scripting, or system administration. | 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 appropriately scoped. Its main weaknesses are the lack of validation steps (e.g., verifying archive contents) and the reference to an external script without showing its contents, which slightly reduces actionability.
Suggestions
Add a verification step after creating the archive, e.g., `tar -tzf out/sample.tgz` to list contents and confirm correctness.
Either inline the contents of `scripts/write_sample.sh` or note what it does so the skill is fully self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. No unnecessary explanations of what shell commands are or how tar works. Every line serves a purpose. | 3 / 3 |
Actionability | Commands are concrete and copy-paste ready, but the skill references `scripts/write_sample.sh` without showing its contents, leaving a gap. The commands themselves are executable but the overall guidance is thin—no error handling or expected output shown. | 2 / 3 |
Workflow Clarity | Steps are listed in a logical sequence (list files → write file → archive), but there are no validation checkpoints. For example, there's no step to verify the archive contents or confirm the sample file was written correctly. | 2 / 3 |
Progressive Disclosure | For a simple skill under 50 lines with a single-purpose scope, the content is well-organized with clear sections (Overview, Examples, Output Files). No need for external references given the simplicity. | 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
0c1ec2b
- 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.