tushare-duckdb-sync

Synchronize Tushare data into DuckDB with metadata and quality reports.

2|1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/shadowinlife/nano_quant_skills --skill tushare-duckdb-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tushare-duckdb-sync
Source: https://github.com/shadowinlife/nano_quant_skills/tree/main/tushare-duckdb-sync
Command: npx skills add https://github.com/shadowinlife/nano_quant_skills --skill tushare-duckdb-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tushare, duckdb, pandas, loguru, and includes scripts (resource) components.

What problem does it solve?

This Skill automates end-to-end synchronization of data from Tushare to local DuckDB, including environment setup, data synchronization, quality checks, and metadata/document generation.

Core Features & Use Cases

  • End-to-end ETL workflow: initializes environment, runs incremental/full sync, and generates metadata docs.
  • Structured data pipeline: produces DuckDB tables with schema, data quality snapshots, and sync state logs.
  • Use Case: A quant team wants to keep DuckDB in sync with Tushare data daily and automatically generate metadata docs for governance.

Quick Start

Run the end-to-end workflow to sync Tushare data into DuckDB, generate metadata, and perform quality checks.

Frequently Asked Questions about tushare-duckdb-sync

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

FAQPage Schema
How do I sync Tushare data to DuckDB incrementally?

To sync Tushare data to DuckDB incrementally, run the end-to-end ETL workflow that supports both full and incremental modes. It automatically logs sync states and updates DuckDB tables across multiple configured data sources.

What is the best way to automate Tushare ETL with data quality checks?

The best way to automate Tushare ETL with data quality checks is using a structured pipeline that ingests data into DuckDB and automatically generates data quality snapshots, sync state logs, and metadata docs for governance.

Do I need pandas and loguru to run Tushare DuckDB synchronization?

Yes, you need pandas and loguru installed, along with tushare and duckdb. These dependencies are required to execute the script-based workflow, manage data frames, and handle logging during synchronization.

Can I generate metadata documentation for DuckDB tables synced from Tushare?

Yes, you can generate metadata documentation for DuckDB tables synced from Tushare by running the end-to-end workflow, which automatically produces schema metadata, provenance documentation, and data quality reports.

Does the Tushare to DuckDB pipeline support cross-session sync state tracking?

Yes, the Tushare to DuckDB pipeline supports cross-session sync state tracking by utilizing a mapping registry. This allows structured ETL pipelines to maintain synchronization logs and configurations across multiple sessions.