user-file-ops
Simple operations on user-provided text files including summarization.
43
Quality
28%
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/user_file_ops/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 operations are supported beyond summarization, lacks natural trigger terms users would say, and provides no guidance on when to use this skill. The generic language would cause conflicts with many other file or text processing skills.
Suggestions
Replace 'simple operations' with specific actions like 'read, search, count words, extract sections, and summarize'
Add a 'Use when...' clause with trigger terms like 'summarize file', 'read text file', '.txt', 'analyze document content'
Include file type specificity (e.g., '.txt files', 'plain text') to distinguish from PDF, Word, or other document skills
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'simple operations' without specifying what those operations are. Only 'summarization' is named as a concrete action, which is insufficient. | 1 / 3 |
Completeness | Weakly answers 'what' with vague 'simple operations' and completely missing any 'when' clause or explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Contains only generic terms like 'text files' and 'summarization'. Missing natural user terms like 'summarize', 'read file', 'analyze text', '.txt', or specific operation keywords users would actually say. | 1 / 3 |
Distinctiveness Conflict Risk | 'Text files' and 'operations' are extremely generic and would conflict with many other skills involving file processing, document handling, or text analysis. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a functional overview of text file summarization with concrete command examples, but suffers from repetitive examples that don't add value and missing script implementation details. The lack of error handling guidance and validation steps weakens the workflow clarity for what should be a straightforward operation.
Suggestions
Reduce the three nearly identical examples to one example with a note that the pattern applies to any input/output path combination
Show the actual content or key logic of scripts/summarize_file.sh so Claude understands what 'summarize' means (statistics, preview, etc.)
Add basic error handling guidance: what to do if the input file doesn't exist or the script returns an error
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary explanation about file locations that Claude could infer. The examples are repetitive - three nearly identical command invocations add little value beyond the first. | 2 / 3 |
Actionability | Provides concrete bash commands that are executable, but the actual script content is not shown. Users cannot verify what summarize_file.sh does or troubleshoot issues without seeing the implementation. | 2 / 3 |
Workflow Clarity | For a simple single-step operation, the workflow is clear enough, but there's no validation or error handling guidance. What happens if the input file doesn't exist or the script fails? No feedback loop is provided. | 2 / 3 |
Progressive Disclosure | For a simple skill under 50 lines with a single purpose, the structure is appropriate. Clear sections for overview, examples, and outputs. No need for external references given the scope. | 3 / 3 |
Total | 9 / 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.