map

Normalize heterogeneous categorical values into canonical forms via the soria CLI.

1|1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Soria-Inc/soria-stack --skill map-soria-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map
Source: https://github.com/Soria-Inc/soria-stack/tree/main/map
Command: npx skills add https://github.com/Soria-Inc/soria-stack --skill map-soria-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Value mapping resolves inconsistent categorical labels and value drift across extracted datasets so analytics and downstream models can rely on stable, canonical concepts rather than noisy source strings.

Core Features & Use Cases

  • Survey & Inventory: Sweep ingest artifacts to report which columns have canonicals, mapped, and unmapped values before any work begins.
  • Indexing & Bulk Fixes: Index distinct values for a column, batch-resolve typos and encoding/casing variants, and create new canonicals where appropriate.
  • Human-in-the-loop Decisions: Flag methodology changes and corporate transitions for review instead of auto-resolving, and produce rationale-backed artifacts for approvals.
  • Operational Safety: Require environment checks to avoid accidental production writes and emit timestamped mapping artifacts for promotion via the soria workflow.
  • Use Case: Clean 75 variant metric_name values into 80 canonicals by batching typos, documenting convention choices, and requesting human review for ambiguous pairs.

Quick Start

Map the metric_name column for a target group by indexing its distinct values, batch-applying obvious typo fixes, flagging ambiguous pairs for review, and saving the mapping artifact for promotion.

Frequently Asked Questions about map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I normalize heterogeneous categorical values into canonical forms for cross-era analytics?

To normalize heterogeneous categorical values, index distinct values, batch-resolve typos and casing, flag methodology or corporate-transition cases for human review, and prepare mapping summaries. This resolves value drift so analytics can rely on stable canonical concepts rather than noisy source strings.

What is the best way to batch-resolve typos and encoding variants in data cleaning pipelines?

The best way to batch-resolve typos and encoding variants in data cleaning pipelines is to index distinct values for a column, batch-apply obvious typo fixes, and create new canonicals where appropriate. This operates via the soria CLI using soria value index and soria value map commands.

How do I flag methodology changes and corporate transitions for human review during ETL?

To flag methodology changes and corporate transitions during ETL, the system flags ambiguous pairs for review instead of auto-resolving them. It produces rationale-backed mapping artifacts for approvals, ensuring human-in-the-loop decisions are documented before promotion workflows.

Does this value mapping process require environment checks before writes?

Yes, the value mapping process requires environment safety checks before writes to avoid accidental production writes. It enforces these checks and emits timestamped mapping artifacts for promotion via the soria workflow, ensuring operational safety.

Can I use this to clean 75 variant metric_name values into 80 canonicals?

Yes, you can clean 75 variant metric_name values into 80 canonicals by batching typos, documenting convention choices, and requesting human review for ambiguous pairs. This specific use case is supported by the indexing and bulk fixes feature.

Why does my data pipeline output inconsistent categorical labels across different scraper eras?

Data pipelines output inconsistent categorical labels across scraper eras due to value drift and noisy source strings. Value mapping resolves this by sweeping ingest artifacts to report which columns have canonicals, mapped, and unmapped values before any work begins.