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 body is a well-organized, fully executable quick-start for a simple single-script skill: exact commands, correct paths, non-obvious staging conventions documented, and a verified bundle script. Its only flaw is mild redundancy — Example 2 adds nothing over Example 1 — which keeps conciseness just short of the top anchor.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows; the "work/inputs/" vs "out/" staging paragraph is genuinely non-obvious operational context. However, Example 2 repeats Example 1 verbatim with only filenames changed, which is minor trimmable redundancy — efficient with minor instances that could be trimmed, matching the level-4 anchor rather than the every-token-earns-its-place level 5.

4 / 5

Actionability

All three examples are fully executable, copy-paste-ready bash commands with exact argument order (verified against scripts/summarize_file.sh's two-argument usage), covering the common cases: an existing workspace file, a differently named input, and a file produced by another skill. This matches the anchor for fully executable commands whose examples cover the common cases.

5 / 5

Workflow Clarity

This is a simple single-task skill with an unambiguous single action: one script, two arguments, exact invocation syntax shown. Per the simple-skill exception the workflow can score 5 when the single action is unambiguous, which it is; the operation is neither destructive nor batch, so the validation-cap rule does not apply.

5 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (Overview, Examples, Output Files) and no need for external reference files; the single referenced bundle path, scripts/summarize_file.sh, exists and matches the documented usage. Per the under-50-lines guideline, well-organized sections alone earn the top score.

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 names a clear domain and one concrete action, but it is a bare minimum statement: no "when to use" trigger guidance, no enumeration of the actual operations (statistics, preview), and thin keyword coverage. It is serviceable but would leave both users and Claude guessing about when to invoke it over a similar skill.

Suggestions

Add a "Use when..." clause naming the trigger scenarios, e.g. "Use when the user provides a text file and asks for a summary, word/line/byte counts, or a quick preview of its contents."

Enumerate the concrete operations the skill performs instead of "Simple operations" — e.g. "Computes line/word/byte statistics, captures a 20-line preview, and writes a summary file."

Include natural trigger synonyms and extensions users would say ("summarize", "word count", "file stats", ".txt") to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

"user-provided text files" names the domain and "summarization" gives one concrete action, but "Simple operations" is generic and the other capabilities the body documents (basic statistics, preview capture) are absent. This matches the anchor for naming a domain with 1-2 concrete actions without comprehensive coverage, not the level above which requires several specific listed actions.

3 / 5

Completeness

The description answers "what" ("operations on user-provided text files including summarization") but contains no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. The "what" is concrete enough to sit at the cap rather than drop to the vague-what/no-when anchor at 2.

3 / 5

Trigger Term Quality

Natural phrases like "summarization" and "text files" are present, but common variations users would actually say are missing ("summarize", "word count", "file stats", ".txt", "preview"). Keyword coverage is relevant but incomplete, matching the anchor for some relevant keywords missing common variations rather than the sparse-generic level below or the good-coverage level above.

3 / 5

Distinctiveness Conflict Risk

"User-provided text files" narrows the scope beyond a fully generic claim, but the description would plausibly trigger for any summarization or text-file-processing skill. It sits at the somewhat-specific-but-overlapping anchor, below the mostly-distinct level which would require more distinguishing trigger phrases.

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.

Validation — 16 / 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.