list-quality-scorecard

Grades lead list CSVs across eight quality dimensions and outputs a letter grade with fixes.

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill list-quality-scorecard-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-quality-scorecard
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/list-quality-scorecard
Command: npx skills add https://github.com/meloShaya/insteltech --skill list-quality-scorecard-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Cold email campaigns fail when lists contain duplicates, unverified emails, bad titles, or off-ICP leads, burning domain reputation before copy even matters. This Skill scores a lead list before sending so preventable waste is caught in minutes. ## Core Features & Use Cases - Eight-dimension scoring: Grades email verification coverage, duplicate emails, duplicate domains, title relevance, bad-title patterns, catch-all density, ICP fit, and name quality, each 0-100. - Letter grade with action items: Produces an A+ to F grade (verification and ICP fit weighted 2x), the top 5 issues to fix, and a pre-send checklist as a markdown report. - ICP comparison: Accepts an optional client-profile.yaml to check title, industry, and headcount fit against declared targeting filters. - Use Case: After enriching 2,000 leads and before uploading to Smartlead, run the scorecard to discover 8% catch-all addresses and 3% coordinator titles, filter them, and re-run until the list reaches grade B. ## Quick Start Ask the AI to run the list quality scorecard on your leads.csv file, optionally against your client-profile.yaml, and show the grade plus top issues to fix.

Frequently Asked Questions about list-quality-scorecard

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

FAQPage Schema
How do I check lead list quality before sending cold email?

Run the scorecard script with npx tsx scripts/score-list.ts --list=leads.csv. It grades eight dimensions including verification coverage, duplicates, and catch-all density, then outputs a letter grade with the top issues to fix.

What CSV columns does the lead list scorer require?

At minimum it needs email, first_name, last_name, and job_title or title, plus company_name or company. Optional columns like company_domain, company_industry, and company_headcount enable domain and ICP fit scoring.

How does the scorecard check ICP fit for a lead list?

Pass --icp-file=client-profile.yaml containing job_titles, industries_in, and headcount_min/max values. The script then scores what percentage of leads match your declared title, industry, and headcount filters.

What happens if my lead list has no email verification column?

The verification dimension scores 0 and the report flags that no verification column exists, instructing you to run the list through MillionVerifier first. Verification is weighted 2x, so missing it heavily lowers the grade.

When should I not use a list quality scorecard?

Skip it for lists under 100 leads since the sample is too small for reliable statistics, and for fully static lists that never change between sends. In those cases check once and reuse the result.