Claude skill pro práci s Dance · Signals Dance Docs

Claude skill pro práci s Dance

Skill pro Claude Code / Claude, který umí analyzovat Dance data a upravovat konfiguraci modelu

SKILL.md

references/architektura.md

references/config.md

references/tabulky-L3.md

references/tabulky-L2-L1.md

references/analyzy.md

references/moduly-volitelne.md

K Dance modelu existuje skill pro Claude (Claude Code, Claude Desktop,

claude.ai⁠

) s názvem dance. Skill je sada instrukcí a referenčních materiálů, díky kterým Claude rozumí struktuře modelu (L1 → L2 → L3), pravidlům práce s privacy Cookies / Anonymous, konfiguraci v includes/config.js i volitelným modulům – a nemusí je při každém úkolu znovu odvozovat z kódu. Výsledkem jsou rychlejší a konzistentnější analýzy nad Dance daty a bezpečnější úpravy konfigurace.

Skill se načítá po částech: v kontextu je trvale jen krátký popis (kdy skill použít). Tělo skillu se načte až při úkolu, který se Dance týká, a jednotlivé referenční soubory jen tehdy, když je Claude potřebuje. Skill sám nic neodesílá ani nespouští – jen říká Claude, jak s modelem pracovat.

Co skill umí

Analýzy nad L3 / L2 tabulkami – vybere správnou tabulku pro otázku (zdroje návštěv, bounce rate, transakce, produkty, stránky, funnely), napíše SQL s partition filtrem, rozpadem podle privacy a správnou měnou (reporting_*), a doprovodí ho vysvětlením, co je měřeno a co odhad.

Úpravy konfigurace modelu – nová GA4 property, nový event parametr nebo user property, konverzní eventy, měny a reportovací měna, časové pásmo, custom sloupce v L2, CMP eventy. Vždy přes includes/config.js, ne přes zásah do .sqlx.

Vysvětlení nápočtu – jak vzniká L1_model_base (privacy, session atribuce, gclid/srsltid přepis, 91denní fallback), jak funguje checkpoint a tabulka L1_model_recalculation, intraday běh a backfill.

Volitelné moduly – user stitching (identity graph), AB testování, atribuce, Shoptet, Google Ads vrstva, cost monitoring: co dávají, jak se konfigurují a jak poznat, že je klient má.

Pro koho je

Analytici s přístupem do repa i BigQuery – využijí obě části: analýzy i práci s modelem (config, compile, backfill).

Uživatelé jen s BigQuery (bez repa) – využijí část o analýzách: katalog tabulek, recepty SQL a pravidla interpretace. Skill je vede k tomu, aby si projekt a dataset_id ověřili přes INFORMATION_SCHEMA.

Instalace

Skill tvoří sedm textových souborů: SKILL.md a šest souborů ve složce references/. Plný obsah všech souborů je na podstránkách této stránky – zkopírujte každý kódový blok do souboru se stejným názvem a složte tuto strukturu (u souborů rozdělených do dvou bloků spojte bloky za sebe):

dance/

├── SKILL.md

└── references/

├── architektura.md

├── config.md

├── tabulky-L3.md

├── tabulky-L2-L1.md

├── analyzy.md

└── moduly-volitelne.md

Složku dance/ pak umístěte tam, odkud ji Claude načítá. Kdo má přístup do Dance repa, najde stejné soubory ve složce skills/dance/ a může je jen nasymlinkovat.

Claude Code – v konkrétním projektu. Složku dance/ uložte do .claude/skills/ v rootu projektu (v Dance repu stačí symlink na skills/dance):

mkdir -p .claude/skills && ln -s ../../skills/dance .claude/skills/dance

Claude Code – pro všechny projekty na svém počítači (doporučeno pro práci jen s BigQuery). Složku dance/ uložte do uživatelských skillů:

mkdir -p ~/.claude/skills && cp -r dance ~/.claude/skills/dance

Claude Desktop /

claude.ai⁠

. Složku dance/ zabalte do ZIPu (soubor SKILL.md musí být přímo ve složce dance/ uvnitř archivu), přejmenujte na dance.skill a nahrajte v nastavení skillů. Hotový balíček lze také vyžádat od správce Dance repa.

Jak se používá

Po instalaci stačí zadávat úkoly běžnou řečí, skill se aktivuje sám podle popisu. Ručně jde vyvolat příkazem /dance. Příklady zadání:

„Spočítej bounce rate za srpen po zdrojích a zařízení, včetně anonymních návštěvníků."

„Kolik jsme za Q2 udělali tržeb podle kanálu a kolik z toho jsou anonymní objednávky?"

„Přidej novou GA4 property analytics_987654321, doména

shop.example.sk⁠

, měna EUR."

„Nastav AB test checkout_button_20260915, parametr experiment, varianty cb_old (kontrola) a cb_new, metrika purchase do 5 dnů."

„Vysvětli, proč má tahle session zdroj google / cpc, když přišla z newsletteru."

Claude si nejdřív ověří kontext repa (projekt z dataform.json, dataset_id a měny z config.js, které moduly jsou v definitions/), pak teprve píše SQL nebo upravuje config.

Struktura skillu

SKILL.md – rozcestník: kdy skill použít, jak zjistit kontext repa, zlatá pravidla analýz a úprav, tabulka volitelných modulů a odkazy na reference. Načítá se při každém Dance úkolu.

references/architektura.md – jak vzniká L1_model_base krok za krokem, L2 a L3 vrstva, checkpoint a recalc tabulka, intraday, backfill, tagy, konvence sloupců, jak napsat nový L3 model.

references/config.md – includes/config.js blok po bloku a návody (nová property, parametr, konverze, měny, timezone, custom sloupce, CMP), včetně postupu při změně schématu L1_model_base (bq update).

references/tabulky-L3.md – katalog L3 tabulek: grain, zdroj, metriky, omezení, ukázkové dotazy.

references/tabulky-L2-L1.md – L2 sessions / events / items a jejich _vw, klíčové sloupce L1_model_base_vw, kdy sáhnout níž.

references/analyzy.md – postup analýzy, recepty SQL, kontroly konzistence, srovnání s GA4 UI, časté chyby.

references/moduly-volitelne.md – identity graph, AB testování, atribuce, Shoptet, Google Ads, cost monitoring, demo anomálie.

Zásady, které skill při analýzách vynucuje

L3 → L2_vw → L1_vw v tomto pořadí; raw GA4 events_* jen pro ověření nápočtu L1.

Vždy filtr na event_date (partition) a typicky i dataset_id.

Cookies a Anonymous jsou dvě různé populace: pro Anonymous neexistuje počet uživatelů a „session“ je odhad přes session_start. Čísla se vykazují rozpadnutá po privacy.

Tržby přes více datasetů vždy v reporting_* sloupcích; NULL znamená chybějící kurz, ne nulu.

session_count není aditivní přes dimenze, které nejsou vlastností session (event_name, stránka).

Poslední ~3 dny se denně přepočítávají – pro srovnání období se berou uzavřené dny.

Transakce se dedupují přes transaction_id; L3_monetization_transactions je už deduplikovaná.

Výsledek vždy uvádí tabulku, období, privacy, měnu a co je odhad.

Zásady při úpravách modelu

Konfigurace před SQL – běžné klientské změny jsou v includes/config.js a includes/ab_tests_config.js, ne v .sqlx.

Blok no_edit_zone v configu se neupravuje; klientské odchylky se zapisují do SPECIFIKA PROJEKTU.

Po každé změně compile (npx @dataform/cli compile, Dataform workspace, nebo rychle node -e "require('./includes/config.js')", které spustí validace identity.validate() a ab_testing.validate()).

Přidání parametru do pivotu event_params je změna vnořeného STRUCTu inkrementální tabulky: nejdřív bq update schématu L1_model_base, pak backfill historie den po dni.

Chirurgické změny – každé klientské repo se od template liší, skill nejdřív čte, co v repu reálně je.

Volitelné moduly nemá každý klient. Skill je popisuje, ale vždy nejdřív ověří, že modul v repu a v BigQuery existuje (složka v definitions/, flag enabled v configu, tabulky přes INFORMATION_SCHEMA). Když modul chybí, řekne to a nenabízí dotazy nad neexistujícími tabulkami.

User stitching (identity graph)

definitions/core/L1_identity/, config.identity.enabled, tabulka L1_dance.L1_customer_map

master_customer_id, is_stitched ve *_vw views, cross-device pohled na zákazníka

AB testování

definitions/ab_testing/, includes/ab_tests_config.js, dataset ab_testing

L3_ab_evaluation (integrita testu), L3_ab_metric_evaluation (verdikt vítěze), user-level statistika

Atribuce

definitions/L3_attribution/, dataset L3_attribution

first / last / linear / position / time-decay + Shapley modely nad cestami sessions

Shoptet

definitions/shoptet/, includes/shoptet_config.js, dataset shoptet

objednávky, položky, kupóny, marže z CSV exportů

Google Ads vrstva

definitions/core/L1_gads/, L2_gads/, includes/gads_config.js

reportingová vrstva nad Google Ads transferem

Cost monitoring

definitions/L1_monitoring/, dataset cost_monitoring

náklady BigQuery jobů per tabulka a den

Anomálie

L3_anomalies.sqlx

demo se syntetickými daty, ne pro reálnou analýzu

⁠

Údržba

Skill popisuje model ke stavu repa v době poslední úpravy. Když se změní názvy sloupců, grain L3 tabulek nebo konfigurační bloky v includes/config.js, je potřeba upravit i příslušný soubor v skills/dance/references/. Testovací zadání pro ověření skillu jsou v skills/dance/evals/evals.json. Zdroj:

GitHub – signals-cz/signalscz-dance, složka skills/dance⁠