waterfall-enrichment

Enrich CSV fields by applying a multi-provider waterfall until a valid result is found.

49|11|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/getaero-io/gtm-eng-skills --skill waterfall-enrichment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: waterfall-enrichment
Source: https://github.com/getaero-io/gtm-eng-skills/tree/main/skills/waterfall-enrichment
Command: npx skills add https://github.com/getaero-io/gtm-eng-skills --skill waterfall-enrichment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables CSV data to be enriched by trying multiple data providers in a waterfall pattern, maximizing coverage while minimizing costs.

Core Features & Use Cases

  • Waterfall across multiple providers: attempt data lookups in sequence and stop at the first successful match.
  • Cost-aware enrichment: reduces spend by avoiding redundant lookups and reusing results per row.
  • End-waterfall exposure: outputs a dedicated column for the resolved value named after the waterfall.

Quick Start

Run a waterfall enrichment on leads.csv to populate the Email column with the first successful provider match.

Frequently Asked Questions about waterfall-enrichment

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

FAQPage Schema
How do I enrich CSV data using multiple providers in a waterfall?

CSV data enrichment uses a multi-provider waterfall to attempt lookups in sequence, stopping at the first successful match to maximize coverage and minimize costs.

What is a waterfall enrichment pattern for lead lists?

A waterfall enrichment pattern queries multiple data providers sequentially for each row, returning the first valid result found to populate contact rosters and company datasets efficiently.

Do I need the Deepline CLI to run multi-provider data enrichment?

Yes, the Deepline CLI is required to run waterfall enrichment, utilizing flags like --with-waterfall, --type, --result-getters, and --end-waterfall to configure provider sequences.

Can I create a dedicated output column for each waterfall enrichment result?

Yes, using the --end-waterfall flag creates a per-waterfall column in the output CSV, exposing the resolved value named after the specific waterfall configuration.

What is the best way to reduce data lookup costs when enriching company datasets?

Applying a cost-aware waterfall enrichment reduces spend by avoiding redundant provider lookups and reusing successful results per row across your company datasets.

Why does my CSV waterfall enrichment stop at the first match?

Waterfall enrichment stops at the first successful provider match by design, ensuring maximum data coverage without incurring unnecessary costs from querying remaining providers.