match-voterfile

Match a signer to Michigan QVF records using exact and fuzzy matching.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/16petero/NomSigAnalysis --skill match-voterfile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: match-voterfile
Source: https://github.com/16petero/NomSigAnalysis/tree/main/.claude/skills/match-voterfile
Command: npx skills add https://github.com/16petero/NomSigAnalysis --skill match-voterfile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps investigators accurately map a single signer to the Michigan Qualified Voter File (QVF) to confirm signature authenticity and provenance, reducing manual lookups and uncertainty.

Core Features & Use Cases

  • Exact key-match queries against the voter file to quickly identify candidates.
  • Fuzzy name and address matching within ZIP or county to resolve close matches.
  • RNC IH Match API fallback when local results are inconclusive, returning the top candidates and a status for downstream review.
  • Output provides the matched QVF record, a match_score, the method used, and a list of considered candidates for human review.

Quick Start

Provide a signer and let the skill return the best matching QVF record with a confidence score.

Frequently Asked Questions about match-voterfile

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

FAQPage Schema
How do I match a signer to the Michigan QVF using fuzzy name and address logic?

The Skill matches signers to the QVF by applying exact key queries, then fuzzy name and address matching within ZIP or county, with an optional API fallback if local results are inconclusive.

What is the best way to verify a signer against a voter file when local data is inconclusive?

The best way to verify a signer against a voter file when local queries fail is enabling the API fallback to fetch top candidate records, returning a status and ranked list for human review.

Can I use the RNC IH Match API as a fallback for resolving ambiguous QVF records?

Yes, you can use the RNC IH Match API as a fallback by enabling the use_rnc_api_fallback flag to fetch top candidates when local QVF exact and fuzzy matching returns inconclusive results.

When do I need fuzzy matching within ZIP or county for voter file verification?

You need fuzzy matching within ZIP or county for voter file verification when exact key queries fail to identify a single candidate, allowing you to resolve close name and address matches.

What outputs do I get when matching signers to the Michigan Qualified Voter File?

Matching signers to the Michigan Qualified Voter File outputs a match status, match_score, the method used, the qvf_record, and candidates_considered for interactive human investigation.

Does voterfile matching require a specific database path for the QVF records?

Yes, voterfile matching requires a voterfile database path as an input alongside the signer object to perform exact and fuzzy queries against the Michigan Qualified Voter File.