data-source-pattern

Standardize external data ingestion into a project database via three patterns.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/exerias21/brainstorm-toolkit --skill data-source-pattern
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: data-source-pattern
Source: https://github.com/exerias21/brainstorm-toolkit/tree/main/skills/data-source-pattern
Command: npx skills add https://github.com/exerias21/brainstorm-toolkit --skill data-source-pattern

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a structured approach to ingest external data into a project's database, ensuring consistency, traceability, and scalable handling of new sources.

Core Features & Use Cases

  • Pattern 1 — Discovery Pipeline (automated, scheduled): defines a cron-driven workflow that fetches external data, deduplicates, upserts into the DB, and emits metrics.
  • Pattern 2 — Seed Script (one-time bulk load): offers idempotent scripts to load static datasets with safe re-run behavior.
  • Pattern 3 — Direct API Ingestion (user or model generated): provides a request/endpoint approach to insert data synchronously with validation.

Quick Start

Define a data source and implement one of the three patterns to ingest it into your database.

Frequently Asked Questions about data-source-pattern

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

FAQPage Schema
What are the standard patterns for data ingestion into a database?

Standard data ingestion patterns include discovery pipelines for scheduled fetches, seed scripts for one-time bulk loads, and direct API ingestion for synchronous inserts. These patterns ensure consistency, traceability, and scalable handling of new external data sources.

How do I build an idempotent seed script for a one-time bulk import?

To build an idempotent seed script for a one-time bulk import, implement safe re-run behavior using the seed script pattern. This approach ensures static datasets load consistently into your database without duplicating records upon multiple executions.

When should I use a discovery pipeline versus direct API ingestion?

Use a discovery pipeline for automated, cron-driven workflows that fetch and upsert external data. Use direct API ingestion when inserting user or model-generated data synchronously with immediate request validation at the endpoint.

How does a discovery pipeline handle web scraping and data quality?

A discovery pipeline handles web scraping by fetching external data, deduplicating records, upserting them into the database, and emitting metrics. This automated workflow maintains data quality and traceability for scheduled ingestion tasks.

Can I use these ETL patterns for synchronous API endpoints?

Yes, you can use the direct API ingestion pattern for synchronous API endpoints. It provides a request and endpoint approach to validate and insert user or model-generated data directly into your project's database.

What artifacts are required to standardize external data ingestion?

Required artifacts for standardizing external data ingestion include cron-driven workflows for discovery pipelines, idempotent scripts for seed loads, and request validation logic for direct API ingestion, ensuring traceable and consistent database integration.