CtrlK
BlogDocsLog inGet started
Tessl Logo

mime-detection-routing

MIME type detection and extractor routing in core/mime.rs — the FORMATS registry that EXT_TO_MIME and SUPPORTED_MIME_TYPES are derived from, the path-based and bytes-based detection functions, priority-based registry selection, wildcard MIME families, and the real procedure for adding a format. Load when adding a format, wiring an extractor to a MIME type, or debugging why a file routes to the wrong (or no) extractor.

71

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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, dense reference-style skill body: lean token use, concrete signatures and paths, a validated add-a-format workflow, and clean section organization. The main gaps are the illustrative-only code snippet and the absence of error-recovery guidance around the verify step.

Suggestions

Make the registry-selection snippet fully executable (or explicitly label it as a usage pattern) by including the imports and error handling needed to run it as written.

Add a short feedback loop after the verify step in 'Adding a New Format': what to check and re-run if counts mismatch (e.g. re-run sync, confirm the new FormatEntry is well-formed).

Format the 'plugin-architecture-patterns' and sync-script references as explicit pointers (path or link) so navigation to related material is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean and information-dense: a compact function table, exact counts verified by a script, and pointed notes like 'there is no m.insert call site to add to, and hand-editing either is impossible' — every token earns its place and nothing explains concepts Claude already knows. It is not 4 because there is no over-explanation anywhere to trim.

5 / 5

Actionability

Guidance is concrete and mostly executable: exact function signatures, file paths ('crates/xberg/src/core/mime.rs', 'extractors/mod.rs::register_default_extractors()'), and commands ('scripts/sync_supported_counts.py sync' then 'verify'). It is not 5 because the registry-selection Rust snippet is illustrative usage rather than copy-paste ready code (no imports/error handling context).

4 / 5

Workflow Clarity

'Adding a New Format' is a clearly numbered 4-step sequence with an explicit validation checkpoint (run sync, then run the verify command). It is not 5 because there is no feedback loop telling Claude what to do when verify fails, and no final post-registration check; it is not 3 because a validation checkpoint is explicitly present rather than implicit.

4 / 5

Progressive Disclosure

The single-file body is well organized into focused sections (Detection Flow, Key Functions, registry, selection, wildcards, add-a-format, Critical Rules) with all detail appropriately inline; references that do appear ('plugin-architecture-patterns', scripts/sync_supported_counts.py) are one level deep. It is not 5 because those cross-references are not clearly signaled as navigable pointers (no path or link format), making discovery rely on inference.

4 / 5

Total

17

/

20

Passed

Description

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

An excellent description: concrete and comprehensive on capabilities, explicit about both what the skill covers and when to load it, with natural trigger phrases and a clearly distinct niche. The only improvement area is broader synonym/extension coverage in the trigger terms.

Suggestions

Add a few synonym trigger phrases such as 'file type detection', 'content sniffing', or 'magic number detection' so users phrasing the need differently still match.

Mention the relevant file extensions or the crate name in the trigger clause to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'the FORMATS registry that EXT_TO_MIME and SUPPORTED_MIME_TYPES are derived from, the path-based and bytes-based detection functions, priority-based registry selection, wildcard MIME families, and the real procedure for adding a format' — giving comprehensive coverage of the skill's scope. It is not 4 because there are no meaningful gaps in capability coverage.

5 / 5

Completeness

It explicitly answers both 'what' (detection and routing in core/mime.rs, the registry, detection functions, selection, wildcards, the add-a-format procedure) and 'when' via the explicit clause 'Load when adding a format, wiring an extractor to a MIME type, or debugging why a file routes to the wrong (or no) extractor.' It is not 4 because the 'when' is fully explicit with concrete trigger phrases, not just present.

5 / 5

Trigger Term Quality

Triggers like 'adding a format', 'wiring an extractor to a MIME type', and 'debugging why a file routes to the wrong (or no) extractor' are natural phrases a developer would say, with good keyword coverage (MIME type, extractor, format). It is not 5 because synonym and extension-level variations (e.g. 'file type detection', 'content sniffing', specific extensions) are sparse.

4 / 5

Distinctiveness Conflict Risk

The description is pinned to a precise niche ('MIME type detection and extractor routing in core/mime.rs') with triggers scoped to format addition, extractor wiring, and routing debugging — minimal overlap with any other skill. It is not 4 because the scoping to this specific subsystem leaves essentially no ambiguity about which skill should trigger.

5 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
xberg-io/xberg
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.