extract-birdkit-tables

Extract Birdkit CTableDouble and CTable data from SSR HTML into typed table structures.

Updated Aug 23, 2025
One-click install
npx skills add https://github.com/therealityreport/trr-app --skill extract-birdkit-tables
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-birdkit-tables
Source: https://github.com/therealityreport/trr-app/tree/main/.agents/skills/design-docs-agent/extract-birdkit-tables
Command: npx skills add https://github.com/therealityreport/trr-app --skill extract-birdkit-tables

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extracts structured data from Birdkit CTableDouble and CTable components rendered in SSR HTML to enable downstream recreation of interactive NYT tables.

Core Features & Use Cases

  • Detect Birdkit tables in HTML via data-birdkit-hydrate attributes and hydration scripts.
  • Extract header, body rows, and sub-table structures for CTableDouble and CTable.
  • Produce a consistent data shape (columns, rows, and route) consumable by chart-data.ts and downstream components.

Quick Start

Run a one-time extraction on SSR HTML to produce the BirdkitTableExtraction data in chart-data.ts format.

Frequently Asked Questions about extract-birdkit-tables

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

FAQPage Schema
How do I extract structured table data from Birdkit SSR HTML on NYT article pages?

Birdkit table extraction detects CTableDouble and CTable components in SSR HTML using data-birdkit-hydrate attributes and hydration scripts. It captures headers, body rows, and sub-tables, producing typed data that follows the BirdkitTableExtraction schema for downstream interactive page recreation.

What is the output format when extracting Birdkit CTable and CTableDouble components?

The extraction output follows the BirdkitTableExtraction schema, providing a consistent data shape that includes route identification, column definitions, and per-table row data. This structured format is specifically designed to be consumable by chart-data.ts and downstream interactive components.

Can I extract both static multi-table grids and interactive dropdown tables from Birdkit pages?

Yes, Birdkit table extraction captures both static multi-table grids and interactive dropdown tables rendered as CTableDouble and CTable elements. It processes the SSR HTML to ensure all table variations are converted into typed row data suitable for downstream chart-data.ts integration.

Do I need any external dependencies to run Birdkit table extraction?

No, Birdkit table extraction operates without any external dependencies. It directly processes the SSR HTML from NYT article pages where Birdkit tables appear, detecting hydration scripts and attributes to generate the typed BirdkitTableExtraction data in a self-contained manner.

What's the best way to automate data extraction from multiple NYT Birdkit tables?

The best way to automate NYT Birdkit table extraction is running a one-time extraction on the SSR HTML. The Skill detects all CTableDouble and CTable instances via hydration attributes, parsing their headers and rows to produce a unified, typed dataset for chart-data.ts.

Why does my Birdkit table extraction fail on dynamically rendered HTML?

Birdkit table extraction targets SSR HTML specifically, relying on static data-birdkit-hydrate attributes and hydration scripts present in the initial server response. If the HTML is rendered dynamically post-load without these SSR markers, the extraction mechanism will not detect the CTable structures.