schema-normalizer

Normalize JSONL interfaces by standardizing IDs, titles, and citation keys.

497|38|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill schema-normalizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-normalizer
Source: https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/schema-normalizer
Command: npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill schema-normalizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the common failure mode in pipelines where inconsistent field names and formats across JSONL files lead to fragile data joins and parsing errors.

Core Features & Use Cases

  • Schema Standardization: Ensures consistent id, title, section_id, and section_title fields across various JSONL artifacts.
  • Citation Key Normalization: Standardizes BibTeX citation keys to raw BibTeX format, reducing parsing drift.
  • Use Case: After generating multiple JSONL outputs from different skills, use this to ensure they all have a common, predictable schema before proceeding to the next stage, preventing errors in downstream analysis or writing.

Quick Start

Normalize the JSONL artifacts in the workspace using the default inputs and outputs.

Frequently Asked Questions about schema-normalizer

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

FAQPage Schema
How do I standardize JSONL fields across multiple pipeline artifacts?

To standardize JSONL fields across pipeline artifacts, this skill enforces consistent id, title, section_id, and section_title fields using outline.yml mappings, resolving schema drift in C2-C4 JSONL artifacts and preventing downstream join failures.

Why does JSONL schema drift cause parsing errors in downstream data joins?

JSONL schema drift causes parsing errors because inconsistent field names and citation key formats across files break deterministic data contracts. This skill normalizes cross-skill JSONL interfaces to resolve these inconsistencies and prevent fragile data joins.

How do I normalize BibTeX citation keys in JSONL data contracts?

You can normalize BibTeX citation keys in JSONL data contracts by validating them against a ref.bib file. This skill standardizes citation keys to raw BibTeX format, reducing parsing drift across multiple JSONL outputs.

When do I need to normalize JSONL interfaces in a data pipeline?

You need to normalize JSONL interfaces in a data pipeline after generating multiple outputs from different skills. Use this standardization step before proceeding to the next stage to ensure a common, predictable schema and prevent downstream analysis or writing errors.

Can I fix inconsistent id and title fields in C2-C4 JSONL artifacts without manual scripting?

Yes, you can fix inconsistent id and title fields in C2-C4 JSONL artifacts without manual scripting. This skill automates the standardization process using outline.yml for ID and title mapping to enforce consistent fields deterministically.

What is the best way to resolve schema drift in cross-skill JSONL pipelines?

The best way to resolve schema drift in cross-skill JSONL pipelines is to enforce deterministic data contracts. This skill standardizes IDs, titles, and citation key formats across artifacts, ensuring consistent fields and preventing downstream parsing failures.