style-qa

Validate citation style changes against oracle JSON results with approve/reject verdicts and numbered findings.

31|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/citum/citum-core --skill style-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: style-qa
Source: https://github.com/citum/citum-core/tree/main/.claude/skills/style-qa
Command: npx skills add https://github.com/citum/citum-core --skill style-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents regressions and hidden defects when authors change citation styles by standardizing a repeatable QA gate for fidelity, formatting, and documented divergence.

Core Features & Use Cases

  • Fidelity verification: checks whether the rendered output continues to match expected oracle results rather than silently drifting.
  • SQI drift assessment: captures SQI drift as a secondary metric to help diagnose quality movement without making it the sole acceptance criterion.
  • Formatting and hygiene audits: evaluates formatting defects and enforces cleanup rules for docs/beans when those areas are touched.
  • Regression surface monitoring: ensures changes do not expand or introduce unintended regression vectors.

Quick Start

Use the style-qa gate on your changed style paths together with the oracle JSON results to get an approve or reject verdict with numbered findings.

Frequently Asked Questions about style-qa

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

FAQPage Schema
How do I prevent citation rendering regressions when modifying style paths?

You can prevent citation rendering regressions by running a QA gate that compares newly rendered output against oracle JSON results. This validates fidelity and produces an approve or reject verdict with numbered findings to stop hidden defects.

What is oracle comparison in citation style regression testing?

Oracle comparison in citation style regression testing validates style changes by matching rendered output against expected oracle JSON results. This mechanism catches silent fidelity drift and prevents unintended quality regressions during style authoring.

How do I automate formatting audits for citation style changes in CI?

Automate formatting audits by integrating this QA gate into your CI-style review workflows. It evaluates formatting defects, enforces cleanup rules for docs and beans, and generates a reject verdict with metrics if hygiene standards are not met.

Does the style QA gate evaluate SQI drift as a primary acceptance criterion?

The style QA gate captures SQI drift as a secondary metric to help diagnose quality movement. It does not use SQI drift as the sole acceptance criterion, prioritizing fidelity verification against oracle JSON results instead.

Can I use this QA gate for docs and beans diffs alongside style changes?

Yes, you can use this QA gate for docs and beans diffs. When style authoring touches those areas, the gate applies formatting and hygiene audits to enforce cleanup rules, ensuring no regression surface is introduced alongside the changes.

When should I not rely solely on automated style fidelity verification?

You should not rely solely on automated style fidelity verification when registered divergences are intentional. The gate enforces decision rules for documented divergences, meaning undocumented deviations from oracle JSON results will trigger a reject verdict.