CtrlK
BlogDocsLog inGet started
Tessl Logo

user-file-ops

Simple operations on user-provided text files including summarization.

61

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./examples/skillrun/skills/user_file_ops/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with executable commands backed by a real bundled script, clear single-task workflow, and clean one-level-deep structure. The only blemish is minor redundancy across the three essentially identical example invocations.

DimensionReasoningScore

Conciseness

The body is lean and mostly assumes competence; the only over-explanation is three near-identical example invocations of the same script that could be collapsed, placing it just above the 'mostly efficient' anchor.

4 / 5

Actionability

It gives fully executable, copy-paste-ready bash commands invoking the real script (verified at scripts/summarize_file.sh) and covers the common input sources, matching the 'fully executable, covers common cases' anchor.

5 / 5

Workflow Clarity

This is a simple single-task skill whose single action (run summarize_file.sh with input and output args) is unambiguous, and the script itself validates inputs, so the simple-skill exception applies; it is not destructive or batch so the cap does not trigger.

5 / 5

Progressive Disclosure

Under 50 lines with well-organized sections (Overview, Examples, Output Files) and a single one-level-deep reference to the real scripts/summarize_file.sh, satisfying the simple-skill exception for clear, well-signaled structure.

5 / 5

Total

19

/

20

Passed

Description

50%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states what the skill does but omits any 'when to use' trigger guidance, capping completeness, and its action coverage is thin with generic phrasing. Trigger terms are present but lack synonyms and natural variations.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers (e.g., 'Use when the user asks to summarize a text file or get line/word/byte counts and a preview').

Replace 'Simple operations' with the specific actions the skill performs (summarize, compute line/word/byte statistics, capture a preview) to lift specificity and distinctiveness.

Include natural synonyms and a file extension (e.g., 'summarize', '.txt', 'text files') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('user-provided text files') and one concrete action ('summarization'), but 'simple operations' is generic and coverage is not comprehensive, matching the anchor for domain + 1-2 concrete actions.

3 / 5

Completeness

It states a clear 'what' (operations on text files including summarization) but provides no 'Use when...' or equivalent trigger guidance, so per the cap, completeness cannot exceed 3.

3 / 5

Trigger Term Quality

'text files' and 'summarization' are relevant keywords a user might say, but common variations/synonyms (e.g., 'summarize', 'preview', file extensions) are missing, fitting the 'some relevant keywords but missing variations' anchor.

3 / 5

Distinctiveness Conflict Risk

'user-provided text files' + 'summarization' gives a somewhat specific niche, but the phrasing is still broad enough to overlap with other file-handling skills, matching the 'somewhat specific but could still overlap' anchor.

3 / 5

Total

12

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
trpc-group/trpc-agent-go
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.