canonical-parser-db

Parse DSL payloads into normalized JSON and SQL models.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/aiob3/llm-readable-kit --skill canonical-parser-db
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: canonical-parser-db
Source: https://github.com/aiob3/llm-readable-kit/tree/main/.opencode/skills/canonical-parser-db
Command: npx skills add https://github.com/aiob3/llm-readable-kit --skill canonical-parser-db

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Implements and maintains the Canonical SSOT parser/validator pipeline (DSL -> normalized JSON -> schema validation -> SQL model) with idempotent event semantics. Use when tasks involve canonical payload parsing, schema evolution, Postgres migration updates, idempotency checks, or CI validation for canonical contracts.

Core Features & Use Cases

  • Parser/normalizer rules in TypeScript (strict formats + invariants).
  • Deterministic idempotency keys and idempotent persistence across deployments.
  • SQL migrations and Core + Event Log model updates.
  • CI gates for canonical contract validation and tests.

Quick Start

Run the canonical parser to validate a sample DSL payload through the end-to-end pipeline (DSL to normalized JSON to schema validation to SQL migration).

Frequently Asked Questions about canonical-parser-db

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

FAQPage Schema
How do I parse a DSL payload into normalized JSON and validate it against a schema?

You can parse a DSL payload into normalized JSON and validate it by running an automated pipeline that enforces strict parser rules and schema invariants. This ensures deterministic idempotency keys and reliable normalized output.

How do I generate deterministic idempotency keys for CI pipeline validation?

Deterministic idempotency keys are generated by applying strict parser rules to normalized payloads during the validation pipeline. This enforces idempotent event semantics and ensures consistent persistence across deployments.

What is the best way to automate Postgres SQL migrations from a normalized JSON schema?

Automating Postgres SQL migrations from a normalized JSON schema involves applying validated migration rules to update the Core and Event Log models. This ensures reliable deployments through CI gates for canonical contract validation.

Does this canonical parser support schema evolution and IAM catalog updates without breaking existing pipelines?

Yes, the canonical parser supports schema evolution and IAM catalog updates by enforcing strict parser invariants and validated migrations. It applies deterministic idempotency checks to ensure reliable deployments without breaking existing CI pipelines.

Why do I need strict parser rules and idempotency checks for canonical contract validation?

Strict parser rules and idempotency checks are needed for canonical contract validation to enforce deterministic idempotency keys and ensure reliable deployments. They prevent schema evolution conflicts and maintain single source of truth integrity.

Can I use this canonical SSOT parser for CI gates without external dependencies?

Yes, you can use the canonical SSOT parser for CI gates without external dependencies. It implements end-to-end TypeScript parser and normalizer rules internally to enforce canonical contract validation and idempotent persistence.