CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

logistics-exception-management

Codified expertise for handling freight exceptions, shipment delays, damages, losses, and carrier disputes. Informed by logistics professionals with 15+ years operational experience.

Quality

76%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/logistics-exception-management/SKILL.md

The canonical home for this skill is logistics-exception-management in administrakt0r/AI-Agents-Safe-Coding-Skills

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 strong instruction-only skill body: dense with genuinely non-obvious domain knowledge, highly actionable thresholds and timelines, and an excellent progressive-disclosure structure that pushes exhaustive material into three well-signaled reference files. The main weaknesses are the absence of a unified end-to-end resolution workflow with explicit validation checkpoints, plus minor trimmable content (persona framing, a duplicated 'When to Use' section).

Suggestions

Add a single numbered end-to-end resolution workflow (intake → classify severity → contain/communicate → document → file claim → close/record) with explicit checkpoints, so the excellent individual frameworks assemble into one followable sequence.

Remove the duplicated 'When to Use' section — the file opens and closes with near-identical trigger text; keep one (the closing version is more detailed).

Trim the 'Role and Context' persona paragraph ('You are a senior freight exceptions analyst with 15+ years...') to one or two lines, keeping the systems inventory and stakeholder map which carry real information.

DimensionReasoningScore

Conciseness

The body is dense, telegraphic, and consistently delivers non-obvious domain facts Claude cannot be assumed to know (Carmack filing deadlines, COGSA per-package limits, terminal manager authority thresholds, settlement percentage floors). It is not 5 because of trimmable material: the persona paragraph in 'Role and Context', a duplicated 'When to Use' section at both the top and bottom of the file, and some flavor text; it is well above 3 because nearly every line carries operational specifics rather than padding.

4 / 5

Actionability

Guidance is concrete and numerically specific throughout — 'file concealed damage claim within 5 days', 'Trigger trace at 24 hours past ETA for FTL, 48 hours for LTL', 'Accept partial settlements above 70%', 'Reject settlements below 90%' — with tone-calibrated example phrasings and an explicit escalation trigger table. It falls short of 5 because no single worked end-to-end example ties the pieces together, and sections like 'Seasonal and Cyclical Patterns' are descriptive context rather than direct instruction.

4 / 5

Workflow Clarity

Decision logic is present (three-axis severity classification, priority sequencing, a five-level escalation chain with timeframes), but there is no unified end-to-end resolution workflow from exception intake through classification, action, documentation, and claim closure. Checkpoints are implicit — e.g. 'Escalate at 30-day mark if no resolution' exists in one threshold list but verification/confirmation steps are not systematically built into the sequences. This matches the anchor for steps listed with validation gaps and implicit checkpoints.

3 / 5

Progressive Disclosure

Structure is exemplary: SKILL.md holds core operational knowledge while full detail is externalized to three real, one-level-deep references (edge-cases.md, decision-frameworks.md, communication-templates.md — all verified present), each clearly signaled at point of need with its purpose ('Brief summaries here — see edge-cases.md for full analysis'; 'Full versions with variables in communication-templates.md'). No nested references, no orphaned links, and inline content is appropriately summarized versions of the externalized material.

5 / 5

Total

16

/

20

Passed

Description

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

A domain-specific description that names its niche and several concrete capability areas, but it omits any 'Use when...' trigger clause, which both caps completeness and weakens discoverability. The trailing provenance sentence ('Informed by logistics professionals with 15+ years...') spends tokens on authority signaling instead of trigger guidance.

Suggestions

Append an explicit trigger clause, e.g. 'Use when a shipment is delayed, damaged, lost, short, or misdelivered, or when filing or disputing a freight claim with a carrier.'

Add the most common natural synonym 'claims' (and ideally 'lost cargo' / 'OS&D') to the capability list so users searching on those terms match the description.

Replace or compress the 'Informed by logistics professionals with 15+ years operational experience' sentence — provenance does not help trigger matching and dilutes token budget.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — 'handling freight exceptions, shipment delays, damages, losses, and carrier disputes' — matching the anchor for several specific actions with minor gaps. It falls short of 5 because coverage omits common actions like claims filing, tracing lost shipments, and shortage/overage handling, and 'codified expertise' is a partially abstract framing.

4 / 5

Completeness

The 'what' is clear (handling freight exceptions, delays, damages, losses, and carrier disputes), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3, and the 'Informed by logistics professionals' sentence adds provenance rather than trigger context.

3 / 5

Trigger Term Quality

Natural user phrases are present ('shipment delays', 'damages', 'losses', 'carrier disputes'), giving good keyword coverage. It is not 5 because key synonyms users would naturally say are missing — most notably 'claims', 'lost shipment/cargo', 'damaged freight', and 'tracking' — and not 3 because multiple natural phrases beyond generic jargon are covered.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — freight exception and carrier dispute handling — with domain-specific terms that would rarely trigger a wrong skill. It is not 4 because the vocabulary (freight exceptions, carrier disputes) is specific enough that overlap with general logistics or supply-chain skills is minimal.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/logistics-exception-management/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.