CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

refunds

Process customer refund requests per company policy.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./samples/SkillsServer/Skills/refunds/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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.

A lean, well-structured instruction skill with concrete thresholds and clear decision branches, weakened by a missing pre-issuance validation step for an irreversible money-movement operation and by references to policy/example files that are absent from the bundle. The second-approval guardrail is stated but not woven into the workflow.

Suggestions

Add an explicit validation checkpoint before issuing money, e.g., 'Re-verify the order date, amount, and policy match; only then issue the refund', since refund issuance is irreversible.

Integrate the 500 USD second-approval rule into the numbered sequence (who approves it, and what to do while waiting) instead of stating it as a detached prohibition.

Ship the referenced files (policy/REFUND_POLICY.md, examples/approved.md, examples/declined.md) or inline the key policy rules — as written, all three references point to files that do not exist.

DimensionReasoningScore

Conciseness

The body is nine lines with zero padding: a one-line trigger ('Use this skill when a customer asks for a refund'), four numbered steps, and one guardrail ('Never issue a refund above 500 USD without a second approval'). It explains nothing Claude already knows and every token earns its place, matching the score-5 anchor 'Lean and efficient; assumes Claude's competence'.

5 / 5

Actionability

Guidance is concrete for an instruction-only skill: specific thresholds ('30-day refund window', 'above 500 USD'), named policy and reply-template files for each decision branch, and coverage of both outcomes (approved and declined with store credit). It stops short of score 5 because the actual mechanism for issuing a refund and for obtaining the 'second approval' is unspecified, leaving a minor execution gap.

4 / 5

Workflow Clarity

Steps are numbered with a clear refundable/not-refundable branch, but issuing a refund is an irreversible financial operation and there is no validation checkpoint before money moves (e.g., confirm order/amount against the policy before issuing). The 500 USD second-approval rule sits outside the sequence as a prohibition rather than an integrated step. Per the guideline capping destructive operations without validation at 3, this matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' — above score 2 due to the coherent sequence and branch, below score 4 due to the missing checkpoints.

3 / 5

Progressive Disclosure

The references ('policy/REFUND_POLICY.md', 'examples/approved.md', 'examples/declined.md') are one level deep and clearly signaled at the point of use, which is good structure. However, none of these files exist in the skill bundle — there are no policy/ or examples/ directories — so the references dangle and navigation breaks. This lands at 3 ('Some structure but could be better organized; references present but not clearly signaled'): not 4 because unresolved references are more than a minor organization gap, not 2 because the in-body structure and signaling are appropriate.

3 / 5

Total

15

/

20

Passed

Description

53%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 is concise, in third person, and names a distinct domain, but it states only a single generic action and entirely omits any trigger guidance for when the skill should be used. It reads closer to a title than a capability description with activation conditions.

Suggestions

Add an explicit trigger clause, e.g., 'Use when a customer asks for a refund, a money-back request, or reimbursement for an order.'

Enumerate the concrete actions the skill performs (verify the 30-day refund window, check policy eligibility, issue the refund, offer store credit) so the 'what' is comprehensive rather than a single 'process' verb.

Include common user phrasings/synonyms such as 'money back', 'reimbursement', or 'return' to improve trigger term coverage.

DimensionReasoningScore

Specificity

"Process customer refund requests per company policy" names the domain (customer refunds) and a single action governed by policy, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' (e.g., 'Processes PDF files and extracts content'). It is above score 2 ('Processes PDF files') because 'customer refund requests per company policy' adds concrete scope beyond a bare domain, but below score 4 because only one generic action verb is listed with no breakdown of what processing entails.

3 / 5

Completeness

The 'what' is clearly stated ('Process customer refund requests per company policy') but there is no 'when' clause at all — no 'Use when...' or equivalent trigger guidance — which caps completeness at 3 per the judging guidelines. This matches the anchor 'Has a clear "what" but "when" is missing or only weakly implied'; it cannot be 4 because that anchor requires both what and when.

3 / 5

Trigger Term Quality

"refund" / "refund requests" are natural terms a user would say, but common variations like 'money back', 'reimbursement', or 'return' are absent, matching the score-3 anchor 'Some relevant keywords but missing common variations or synonyms' ('Works with PDF files'). It is not score 4 because the keyword set is essentially one term, and not score 2 because 'refund' is a genuinely natural user phrase rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

'Customer refund requests' carves out a fairly distinct billing niche with the natural trigger 'refund', matching the score-4 anchor 'Mostly distinct; minor overlap risk with closely related skills'. It is not 5 because adjacent skills (billing, order cancellation, payment disputes/chargebacks) could plausibly overlap on the single keyword 'refund' without more qualifying triggers.

4 / 5

Total

13

/

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

modelcontextprotocol/csharp-sdk

Path

samples/SkillsServer/Skills/refunds/SKILL.md

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.