audit-parity

Verify Python and TypeScript implementations produce identical outputs via JSON comparisons.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/ammonfife/sakima.co --skill audit-parity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-parity
Source: https://github.com/ammonfife/sakima.co/tree/main/.claude/skills/audit-parity
Command: npx skills add https://github.com/ammonfife/sakima.co --skill audit-parity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytest, json, difflib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill verifies that a Python module and its TypeScript port produce identical results for the same inputs, ensuring consistency across platforms.

Core Features & Use Cases

  • Cross-Platform Verification: Audits the parity between Python and TypeScript implementations.
  • Automated Test Execution: Runs predefined tests against both implementations.
  • Side-by-Side Diff: Generates a diff artifact for visual comparison of outputs.
  • Structured JSON Output: Provides machine-readable results for automated processing.

Quick Start

Run the audit-parity skill to verify parity between the 'auction_tools' module and its TypeScript port.

Frequently Asked Questions about audit-parity

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

FAQPage Schema
How do I verify code parity between a Python module and a TypeScript port?

To verify code parity between Python and TypeScript, run predefined tests against both implementations and compare outputs using structured JSON. This process ensures both platforms produce identical results for the same inputs.

Why does my TypeScript port return different results than the original Python module?

Differences between a TypeScript port and a Python module occur when code parity is broken. Running a cross-platform audit with a side-by-side diff artifact visualizes output mismatches to identify the exact behavioral inconsistencies.

Do I need pytest to check behavior parity between Python and TypeScript implementations?

Yes, pytest is required to execute predefined tests for the behavior parity check. The audit relies on pytest to run the Python implementation tests and compare the results against the TypeScript port outputs.

What is the best way to generate a machine-readable diff for cross-platform code audits?

The best way to generate a machine-readable diff for cross-platform code audits is to execute predefined tests and output the comparison results as structured JSON, which enables automated processing of parity checks.

Can I use a side-by-side diff artifact to debug mismatches in cross-platform implementations?

Yes, you can use a side-by-side diff artifact to debug cross-platform implementation mismatches. The audit generates this visual comparison to highlight exact differences between Python and TypeScript test outputs.

When do I need to run a parity check on my Python and TypeScript code?

You need to run a parity check when porting Python code to TypeScript or updating shared logic to ensure behavior consistency. It verifies both implementations execute identically across platforms for the same inputs.