hkscc-screener

Filter HKSCC holdings to quarterly snapshots with multi-quarter continuity.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/chinawrj/agent-skills-stock --skill hkscc-screener
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hkscc-screener
Source: https://github.com/chinawrj/agent-skills-stock/tree/main/.github/skills/hkscc-screener
Command: npx skills add https://github.com/chinawrj/agent-skills-stock --skill hkscc-screener

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill filters HKSCC (港股通) holdings to surface stock candidates that exhibit durable, multi-quarter ownership patterns by foreign or institutional investors.

Core Features & Use Cases

  • Quarterly snapshot generation: down-samples daily HKSCC holdings to the quarter-end snapshot for stable comparison.
  • Multi-quarter continuity check: requires a stock to have at least N consecutive quarters of holding data.
  • Market-cap filtering: enforces minimum holding market cap and total market cap ranges to focus on investable candidates.
  • Universe intersection: retains only codes present in a provided universe (non-SOE) dataset.

Quick Start

Run the screening pipeline locally by executing the fetch_hkscc.py, hkscc_quarterly.py, and screen_hkscc.py scripts in sequence.

Frequently Asked Questions about hkscc-screener

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

FAQPage Schema
How do I filter HKSCC holdings to find stocks with durable multi-quarter ownership?▼

Filter HKSCC holdings by down-sampling daily data to quarterly snapshots, enforcing minimum N consecutive quarters of holding continuity, and intersecting with a target stock universe to identify durable candidates.

What is the best way to down-sample daily Hong Kong Stock Connect data for quarterly analysis?▼

Down-sample daily HKSCC data to quarterly snapshots using pandas and pd.Period('Q') for quarter arithmetic, creating stable quarter-end snapshots for consistent multi-quarter ownership comparison.

Does this HKSCC screening workflow require DuckDB and pandas?▼

Yes, the HKSCC screening workflow requires both DuckDB and pandas to process quarterly holdings data, enforce continuity checks, apply market-cap filters, and output results to a parquet file.

Can I apply market-cap filtering and universe intersection to HKSCC quarterly snapshots?▼

Yes, you can enforce minimum holding market cap and total market cap ranges on quarterly HKSCC snapshots, then intersect the results with a provided non-SOE universe dataset to retain investable candidates.

What scripts do I need to run for screening HKSCC holdings locally?▼

Run the fetch_hkscc.py, hkscc_quarterly.py, and screen_hkscc.py scripts in sequence to fetch data, generate quarterly snapshots, and screen for durable foreign-led HKSCC holdings.

Why use quarterly snapshots instead of daily data for identifying continuous foreign holdings?▼

Quarterly snapshots provide stable comparison points by down-sampling volatile daily HKSCC data, ensuring that multi-quarter continuity checks accurately surface durable institutional ownership patterns.