CtrlK
BlogDocsLog inGet started
Tessl Logo

returns-reverse-logistics

Codified expertise for returns authorisation, receipt and inspection, disposition decisions, refund processing, fraud detection, and warranty claims management.

44

Quality

46%

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 ./skills/returns-reverse-logistics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%Scale 1-5

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

This skill reads more like a comprehensive retail operations training manual than a concise, actionable skill for Claude. Its greatest strength is the depth of domain knowledge captured in the decision frameworks, fraud scoring model, and escalation protocols. However, it is severely over-long, explains many concepts Claude already understands, lacks executable steps or code, and inlines content that it simultaneously claims lives in reference files.

Suggestions

Reduce the content by 60-70% by removing explanations of basic concepts (what wardrobing is, what a restocking fee covers, how gift receipts work) and trusting Claude's existing knowledge. Focus on the specific decision rules, thresholds, and scoring models unique to this operation.

Convert the implicit workflow into an explicit numbered sequence with validation checkpoints, e.g.: 1. Evaluate policy eligibility → 2. Issue RMA → 3. Receive and inspect → 4. Grade (validate grade with second inspector for items >$500) → 5. Route disposition → 6. Process refund → 7. Verify refund posted.

Move the detailed fraud scoring table, disposition matrix, and vendor recovery frameworks entirely into the referenced decision-frameworks.md file rather than duplicating them inline. Keep only a brief summary with a clear pointer in the main SKILL.md.

Remove the duplicate 'When to Use' section (appears at both the top and bottom of the file) and consolidate into a single, concise trigger description.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~350+ lines, extensively explaining concepts like what a PDF return policy is, how grading works, what wardrobing means, and general retail knowledge that Claude already possesses. Much of this reads like a training manual for a human employee rather than concise instructions for an AI. The detailed explanations of fraud types, inspection timing benchmarks, and retail industry context are largely unnecessary padding.

2 / 5

Actionability

The skill provides structured decision frameworks (disposition tables, fraud scoring model, vendor recovery ROI formulas, escalation triggers) which are somewhat actionable, but there is no executable code, no concrete commands, and no specific system interactions. The guidance is more encyclopedic reference material than step-by-step executable instructions. The fraud scoring table and disposition matrix are useful but remain conceptual rather than implementable.

3 / 5

Workflow Clarity

While there are implicit workflows (policy evaluation → inspection → grading → disposition → refund/recovery), they are not presented as clear sequential steps with explicit validation checkpoints. The escalation table provides good trigger-action pairs, but the core returns processing workflow lacks a numbered step-by-step sequence with validation gates. The return policy exception logic (5-step evaluation) is the closest to a proper workflow but lacks verification steps.

3 / 5

Progressive Disclosure

The skill references three external files (edge-cases.md, decision-frameworks.md, communication-templates.md) which is good structure, but the main SKILL.md itself contains enormous amounts of detail that should be in those reference files rather than inline. The disposition table, fraud scoring model, and vendor recovery frameworks are referenced as being in decision-frameworks.md but are also fully detailed inline, creating redundancy. No bundle files were provided to verify the references exist.

3 / 5

Total

11

/

20

Passed

Description

50%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 lists a reasonable set of specific return-management capabilities, giving it decent specificity and distinctiveness. However, it lacks any 'Use when...' trigger guidance, uses the vague opener 'Codified expertise' which is not actionable, and misses common natural language terms users would employ when requesting help with returns or refunds.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases, e.g., 'Use when the user asks about processing a return, issuing a refund, handling an RMA, or managing warranty claims.'

Replace the abstract opener 'Codified expertise for' with active verbs describing what the skill does, e.g., 'Processes return authorizations, inspects returned items, determines disposition...'

Include common synonyms and natural user terms such as 'RMA', 'return request', 'exchange', 'return policy', 'product return' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Lists several specific actions: returns authorisation, receipt and inspection, disposition decisions, refund processing, fraud detection, and warranty claims management. These are concrete domain actions, though they read more like a category list than detailed capabilities.

4 / 5

Completeness

Provides a 'what' (list of return-related processes) but has no 'when' clause or trigger guidance. The absence of a 'Use when...' clause caps this at 3 per the rubric, and the 'what' is more of a topic list than a clear functional description, bringing it to 2.

2 / 5

Trigger Term Quality

Contains relevant domain keywords like 'returns', 'refund', 'fraud detection', 'warranty claims', but misses natural user phrases (e.g., 'return a product', 'RMA', 'exchange', 'return policy'). The term 'codified expertise' is jargon that users would never say.

3 / 5

Distinctiveness Conflict Risk

The returns/refund/warranty domain is fairly specific and unlikely to overlap with most other skills. However, 'fraud detection' could overlap with a general fraud or security skill, creating minor conflict risk.

4 / 5

Total

13

/

20

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.