mime-detection-routing

MIME type detection and extractor routing in core/mime.rs and core/extractor/bytes.rs — the extension→EXT_TO_MIME→validate→registry→extractor flow, key detection functions, the 118+ case-insensitive extension map, priority-based registry selection, wildcard MIME families, and how to add a new MIME type. Load when adding a format, wiring an extractor to a MIME type, or debugging why a file routes to the wrong (or no) extractor.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

MIME Detection & Routing

Detection Flow

Extension -> EXT_TO_MIME map -> validate -> Registry lookup -> Extractor

Key Functions

Function	Location	Purpose
`detect_mime_type(path, inspect)`	`core/mime.rs`	Extension + optional content inspection
`detect_mime_type_from_bytes(bytes)`	`core/mime.rs`	Magic number detection (infer crate)
`validate_mime_type(mime)`	`core/mime.rs`	Check if any extractor supports it

Extension Mapping

118+ extensions mapped in EXT_TO_MIME (core/mime.rs). Case-insensitive.

Key mappings: .pdf -> application/pdf, .docx -> application/vnd.openxmlformats-officedocument.wordprocessingml.document, .xlsx -> spreadsheet variant, .png/.jpg -> image/*

Registry Selection

// In core/extractor/bytes.rs
fn select_extractor_for_mime(mime_type: &str) -> Result<Arc<dyn DocumentExtractor>> {
    let registry = get_document_extractor_registry();
    let registry_guard = registry.read()?;
    registry_guard.get_for_mime_type(mime_type)
        .ok_or_else(|| XbergError::UnsupportedFormat(mime_type.into()))
}

Selects highest-priority extractor registered for that MIME type.

Adding New MIME Types

Add extension mapping: m.insert("ext", "application/x-new"); in core/mime.rs
Implement DocumentExtractor with supported_mime_types() returning the MIME
Register in register_default_extractors()

Wildcard Support

Extractors can register for MIME type families: "image/*" matches image/png, image/jpeg, etc.

Critical Rules

Always validate_mime_type() before extraction
Extension mapping is case-insensitive
Content inspection (infer crate) is fallback for extension-less files
Registry validation is final authority on supported types

Repository: xberg-io/xberg
Path: .ai-rulez/skills/mime-detection-routing/SKILL.md
Commit: db74878

Last updated: about 23 hours ago
First committed: 10 days ago

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.