test-coverage

Audit citum-core test fixtures and citation scenarios for shape-correct coverage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents false confidence in “tested” claims by ensuring fixtures and citation scenarios exercise the correct reference shapes, field-modes, and behavioral paths in citum-core.

Core Features & Use Cases

  • Shape-aware fixture guidance: identifies the exact reference field shapes required for reliable coverage (e.g., date variants like year-only vs no issued, and contributor variants like editor-only).
  • Oracle- and behavior-contract-first testing: enforces that expected outcomes come from independent sources such as fixtures, oracle output, specs, divergence registers, or explicit contracts (not from the code’s own output).
  • Pre/post checklists for rigorous coverage: supports audits using the coverage audit scripts and a workflow checklist for both adding fixtures and updating citation scenarios.

Quick Start

Use this skill when you add a fixture item or write/adjust a Rust test, and run the coverage audit before claiming the behavior is covered.

Frequently Asked Questions about test-coverage

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

FAQPage Schema
How do I prevent false confidence in Rust test coverage for citation rendering?

To prevent false confidence in Rust test coverage for citation rendering, use shape-aware fixtures and oracle-verified expected outcomes from independent sources like specs or divergence registers. This ensures tests genuinely exercise intended behavioral paths rather than relying on the code's own output.

What is oracle-verified testing and how does it stop overfitting in test suites?

Oracle-verified testing stops overfitting by requiring expected outcomes to come from independent sources such as fixtures, oracle output, specs, or explicit contracts, rather than the code's own output. This enforces behavior-contract-first validation and prevents tests from simply mirroring current implementation flaws.

How do I create shape-aware fixtures for testing date and contributor variants in citations?

Create shape-aware fixtures by explicitly defining reference field shapes for date variants like year-only or no issued field, and contributor variants like editor-only. This matrix approach ensures your Rust tests cover the exact field-modes required for reliable citation and rendering behavior validation.

What's the best way to audit test coverage for style rendering and oracle execution?

The best way to audit test coverage for style rendering and oracle execution is to use provided coverage audit scripts alongside a pre/post checklist workflow. This verifies that added fixtures and updated citation scenarios in citations-expanded.json genuinely satisfy the required behavioral paths.

When do I need to link citation scenarios to fixtures using citations-expanded.json?

You need to link citation scenarios to fixtures using citations-expanded.json when implementing features, fixing bugs, or writing Rust tests in citum-core. This linkage ensures your test suite genuinely covers intended citation and rendering behaviors and prevents regression by maintaining scenario coverage.