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 what actions the skill performs, lacks natural trigger terms users would say, and provides no guidance on when Claude should select this skill. The generic 'files' term would cause conflicts with numerous other file-handling skills.
Suggestions
List specific concrete actions like 'compress files to zip/tar, extract archives, copy/move/rename files, change permissions'
Add a 'Use when...' clause with natural trigger terms: 'Use when the user mentions zip, tar, compress, extract, unzip, archive, or needs to manipulate files via command line'
Specify the types of archives supported (zip, tar, gz, 7z) to distinguish from other 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 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'). Missing natural user terms like 'zip', 'tar', 'compress', 'extract', 'unzip', 'copy', 'move', etc. | 1 / 3 |
Distinctiveness Conflict Risk | 'Files' is extremely generic and would conflict with many other skills (PDF handling, Excel processing, etc.). 'Archives' provides some specificity but is still too broad without concrete operations listed. | 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 provides concrete, executable shell commands without unnecessary explanation. The content is appropriately concise and actionable. The main gap is the lack of any validation steps to confirm commands succeeded (e.g., checking file existence or archive contents).
Suggestions
Add a verification step after each command, such as 'ls out/' to confirm file creation or 'tar -tzf out/sample.tgz' to verify archive contents
| 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 guidance. For a skill involving file operations, confirming outputs exist or checking archive 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
8763418
- 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.