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 critically underspecified. It fails to list 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. It needs a complete rewrite with specific capabilities and explicit trigger conditions.
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, extract archives, or perform bulk file operations from the command line.'
Include common file extensions and format names as trigger terms (e.g., '.zip', '.tar.gz', '.7z', 'tarball') to improve distinctiveness and reduce conflict with generic file-handling skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('simple shell utilities') without listing any concrete actions. It doesn't specify what operations are performed on files or archives (e.g., compress, extract, rename, move). | 1 / 3 |
Completeness | The description weakly addresses 'what' (shell utilities for files and archives) and completely omits 'when' — there is no 'Use when...' clause or any explicit trigger guidance. | 1 / 3 |
Trigger Term Quality | The terms 'files' and 'archives' are extremely generic. Missing natural keywords users would say like 'zip', 'tar', 'extract', 'compress', 'unzip', '.gz', 'rename', 'copy', or any specific shell commands. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic — 'files' could overlap with virtually any file-handling skill, and 'shell utilities' is broad enough to conflict with many other skills involving command-line operations. | 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 concise, well-structured simple skill that provides clear shell command examples. Its main weaknesses are the reference to an external script without showing its contents and the lack of any validation steps to confirm commands succeeded. The organization is appropriate for the skill's simplicity.
Suggestions
Add a brief verification step after archiving, e.g., `tar -tzf out/sample.tgz` to list archive contents and confirm success.
Either inline the contents of `scripts/write_sample.sh` or note what it does, so the skill is self-contained and fully actionable.
| 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 a skill involving file creation and archiving, verifying the output exists or checking the archive contents would improve reliability. | 2 / 3 |
Progressive Disclosure | For a simple, short skill under 50 lines with a single-purpose scope, the content is well-organized with clear sections (Overview, Examples, Output Files) and doesn't need external references. | 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
af8bd5f
- 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.