file-tools
Simple shell utilities for files and archives.
55
Quality
43%
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 too vague to be useful for skill selection. It fails to specify concrete actions, lacks natural trigger terms users would say, provides no guidance on when to use it, and would likely conflict with many other file-related skills.
Suggestions
List specific concrete actions like 'compress files to zip/tar, extract archives, list archive contents, create backups'
Add a 'Use when...' clause with natural trigger terms like 'zip', 'unzip', 'tar', 'compress', 'extract', 'archive', '.zip', '.tar.gz'
Specify the types of archives supported (zip, tar, gzip, etc.) to distinguish from other file manipulation skills
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('simple shell utilities') without listing any concrete actions. It doesn't specify what operations can be performed on files or archives. | 1 / 3 |
Completeness | Only vaguely addresses 'what' (shell utilities for files/archives) and completely lacks any 'when' guidance or explicit trigger conditions. | 1 / 3 |
Trigger Term Quality | Contains only generic terms ('files', 'archives', 'shell utilities') that are overly broad. Missing natural user terms like 'zip', 'tar', 'compress', 'extract', 'unzip', etc. | 1 / 3 |
Distinctiveness Conflict Risk | 'Files' is extremely generic and would conflict with many other skills. 'Shell utilities' could overlap with any command-line related skill. No clear niche is established. | 1 / 3 |
Total | 4 / 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-crafted simple skill that demonstrates shell commands efficiently with concrete, executable examples. The content is appropriately concise and actionable. The main gap is the lack of any validation steps to confirm operations succeeded (e.g., checking archive contents or file existence).
Suggestions
Add a verification step after archive creation, such as 'tar -tzf out/sample.tgz' to list contents and confirm the archive is valid
Consider adding a brief check command after file writes, like 'cat out/sample.txt' to verify content
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, providing only the essential commands without explaining what shell commands are or how tar works. Every line serves a purpose. | 3 / 3 |
Actionability | All commands are concrete, copy-paste ready, and executable. The examples show exact syntax with real paths and arguments. | 3 / 3 |
Workflow Clarity | Steps are listed clearly but there's no validation or verification mentioned. For file/archive operations, confirming the archive was created correctly or checking file contents would improve reliability. | 2 / 3 |
Progressive Disclosure | For this simple, single-purpose skill under 50 lines, the organization is appropriate with clear sections (Overview, Examples, Output Files) and no need for external references. | 3 / 3 |
Total | 11 / 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
50ef2f3
- 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.