skills.rest
graphrefly
graphreflyOFFICIAL
Explore all skills by this author →
GitHub

parity

Compare graphrefly-ts and graphrefly-py API surfaces, behavior, and test conformance.

1|Updated Mar 29, 2026
Search Tags:#test coverage#cross-language#parity#api comparison#spec conformance#behavior validation#graphqlrefly
One-click install
npx skills add https://github.com/graphrefly/graphrefly-ts --skill parity
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parity
Source: https://github.com/graphrefly/graphrefly-ts/tree/main/.gemini/skills/parity
Command: npx skills add https://github.com/graphrefly/graphrefly-ts --skill parity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures graphrefly-ts and graphrefly-py stay compatible by systematically comparing API surfaces, behavioral semantics, and test/spec conformance, so cross-language regressions are caught early.

Core Features & Use Cases

  • Cross-language parity reporting: Compares public API naming, signatures, return types, options/kwargs, and error behavior between TypeScript and Python.
  • Spec-first validation: Uses the GraphReFly spec as the authority to classify differences as aligned gaps, spec-decided issues, convention-decided issues, or items needing an explicit decision.
  • Test coverage comparison: Identifies scenarios tested in one language but missing in the other to prevent silent divergence.

Quick Start

Ask for a cross-language parity check between graphrefly-ts and graphrefly-py by saying: "Run parity to compare my requested area across TS and Python, and produce a full report of every difference without applying fixes."

Frequently Asked Questions about parity

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

FAQPage Schema
How do I validate cross-language API parity between TypeScript and Python?▼

Cross-language parity validation compares public API naming, signatures, return types, and error behavior between TypeScript and Python implementations to catch regressions early and ensure spec conformance.

How do I compare test coverage gaps between TS and Python implementations?▼

Test coverage comparison identifies scenarios tested in one language but missing in the other to prevent silent divergence. It checks targeted feature areas or runs full parity checks across both repositories.

What is spec-driven classification for cross-language behavior validation?▼

Spec-driven behavior validation uses the GraphReFly spec as the authority to classify differences as aligned gaps, spec-decided issues, convention-decided issues, or items needing an explicit decision.

Can I run a full parity comparison across both TS and Python repositories?▼

Yes, you can run a full parity comparison across both repositories. The Skill applies to targeted feature areas or full parity runs, producing exhaustive reports of all differences without applying fixes.

Does the parity validation workflow automatically fix detected API differences?▼

No, the parity validation workflow is read-only and halts at the reporting stage. It produces a full report of every difference without applying fixes until explicit approval is provided.

Related Skills

Explore More Software Engineering Skills→
graphreflygraphrefly
1

porting-to-rs

Convert GraphReFly TypeScript slices into Rust implementations per the canonical spec.

Official
Advanced
yutaro0915yutaro0915

cdd-review-decision

Validate DECIDED design decisions for alignment with architecture and related documents before implementation.

Community
Advanced
indykishindykish
2

write-unit-test

Generate test skeletons and coverage guidance for multi-stack code changes.

Community
Advanced
wojonswojons
4

gap-analysis

Compare documentation against source code to detect missing implementations and mismatches.

Community
Advanced