import-prospects

Convert arbitrary contact lists into canonical CSV and import them into LeadAce.

3|Updated May 28, 2026
One-click install
npx skills add https://github.com/aitit-inc/leadace --skill import-prospects-aitit-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: import-prospects
Source: https://github.com/aitit-inc/leadace/tree/main/plugin/skills/import-prospects
Command: npx skills add https://github.com/aitit-inc/leadace --skill import-prospects-aitit-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sales teams often have existing prospect data scattered across CSV exports, Excel spreadsheets, SQLite databases, or plain text files with inconsistent columns. This Skill reads those arbitrary files, maps their columns to LeadAce's canonical prospect schema, and uploads them through the MCP import tool without manual reformatting. ## Core Features & Use Cases - Flexible source parsing: Reads CSV, TSV, XLSX, XLS, ODS, SQLite, and delimited text files, converting spreadsheets via pandas or gnumeric when needed. - Schema mapping with validation: Maps source columns to the canonical schema, derives missing domains and URLs, maps industry values to the controlled vocabulary, and preserves do-not-contact flags so opted-out contacts are never re-contacted. - Two import modes: Saves prospects as tenant-level assets for later linking via /match-prospects, or links every row directly to a specific project with a match reason. - Use Case: You exported 500 leads from an old CRM as an Excel file. Point the Skill at the file, confirm the column mapping and dedup policy, and it uploads a validated canonical CSV, reporting inserted, skipped, and errored rows. ## Quick Start Import the prospects from my file leads-export.xlsx and link them to my existing LeadAce project.

Frequently Asked Questions about import-prospects

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

FAQPage Schema
How do I import a prospect list into LeadAce?

Provide the path to your source file and optionally a project name. The Skill reads the file, maps its columns to the canonical CSV schema, confirms the mapping with you, and uploads it via the import_prospects_from_csv MCP tool.

What file formats can I upload as a prospect list?

CSV, TSV, XLSX, XLS, ODS, SQLite databases, and plain text files with consistent delimiters are supported. Excel and ODS files are converted to CSV using pandas or gnumeric, and SQLite files are queried after you pick a table.

What columns does the LeadAce canonical CSV require?

Required columns are organizationDomain, organizationName, organizationWebsiteUrl, name, overview, and websiteUrl, plus at least one contact channel such as email, contactFormUrl, an SNS account, or platformUrl. The matchReason column is required only in project-linked mode.

Does the import preserve do-not-contact or unsubscribed flags?

Yes. Columns like do_not_contact, dnc, opted_out, or unsubscribed are mapped to the canonical doNotContact flag and imported rather than dropped. This prevents later list-building from rediscovering and contacting people who already opted out.

What is the difference between tenant-only and project-linked import?

Tenant-only mode saves prospects at the tenant level with no projectId, suited for general lead lists you will link later via /match-prospects. Project-linked mode attaches every row to one project with a matchReason, suited for lists built for a single campaign.

Is there a row limit when importing prospects?

Yes, each import accepts a maximum of 1000 data rows. Larger files must be split into multiple canonical CSV files and uploaded in separate calls.