dataset-synthesizer-revisor

Audits JSONL datasets for placeholders, AI apology traces syntax errors and imbalance, producing a Markdown report.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill dataset-synthesizer-revisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dataset-synthesizer-revisor
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/dataset-synthesizer-revisor
Command: npx skills add https://github.com/joleques/northstar-ai --skill dataset-synthesizer-revisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents low-quality JSONL fine-tuning datasets from being used for training by detecting placeholders, AI apology traces, JSON syntax errors, and content imbalance that would degrade model behavior.

Core Features & Use Cases

  • Placeholder and marker detection: Identifies unresolved tokens such as [Preencher...], [INSIRA...], [Seu nome] and other generator artifacts.
  • AI-error and apology tracing: Flags machine-error remnants and "AI-splaining" phrases that should not appear in production training data.
  • JSONL structural validation: Verifies each line is a standalone valid JSON record with required root keys and correct escaping to avoid ingestion failures.
  • Line-by-line audit reporting: Produces a Markdown report with total lines analyzed, problematic line counts, per-line anomaly descriptions, and precise remediation recommendations saved next to the original dataset.
  • Use Case: Data QA and ML engineers validating synthesized datasets for customer support or documentation fine-tuning workflows.

Quick Start

Use the skill to analyze the file path/to/dataset.jsonl and produce a line-by-line Markdown audit report saved next to the original file.

Frequently Asked Questions about dataset-synthesizer-revisor

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

FAQPage Schema
How do I audit a JSONL dataset before fine-tuning a large language model?

To audit a JSONL dataset before fine-tuning, analyze the file line by line to detect placeholders, AI apology traces, JSON syntax errors, and content imbalance. This process outputs a Markdown report with anomaly descriptions and remediation recommendations.

What are common data quality issues in synthesized fine-tuning datasets?

Common data quality issues in synthesized fine-tuning datasets include unresolved placeholder tokens like [Preencher...], machine-error remnants or AI-splaining phrases, invalid JSON structures, and content imbalance that can degrade model behavior during training.

How do I validate JSON syntax errors in a JSONL file for ML data curation?

Validating JSON syntax errors in a JSONL file involves verifying each line is a standalone valid JSON record with required root keys and correct escaping. This structural validation prevents ingestion failures during ML data curation pipelines.

Can I generate a line-by-line audit report for a JSONL training dataset?

You can generate a line-by-line audit report for a JSONL training dataset to receive total line counts, problematic line numbers, anomaly descriptions, and precise remediation recommendations. The report is saved as a Markdown file in the original dataset directory.

Does dataset auditing work for manual exports or only synthesized datasets?

Dataset auditing works for both synthesized datasets and manual exports used for fine-tuning large language models. It detects generator artifacts in synthesized data and structural errors in manual exports, ensuring both meet production training quality standards.

Why should I remove AI apology traces from fine-tuning datasets?

You should remove AI apology traces from fine-tuning datasets because these machine-error remnants and AI-splaining phrases should not appear in production training data. Leaving them in will degrade model behavior and cause the trained model to replicate unwanted patterns.