[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-posthog-modeling-dimension-tables":3,"mdc-hu5ea9-key":48,"related-org-posthog-modeling-dimension-tables":721,"related-repo-posthog-modeling-dimension-tables":900},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":43,"sourceUrl":46,"mdContent":47},"modeling-dimension-tables","build reusable dimension tables","Build reusable dimension \u002F lookup tables for a star schema — country\u002Fregion, timezone, currency, date, plan\u002Fproduct, and other descriptive attributes — on either PostHog data-warehouse views (HogQL) or an external dbt project. Use when the user wants to model dimension tables, lookup tables, a star schema, conformed dimensions, or wants to enrich events\u002Frevenue\u002Fusage with country, region, timezone, plan, or currency attributes without repeating JOINs. Covers sourcing the dimension data (upload, warehouse source, or derive from events), shaping it into an aliased one-row-per-entity view (optionally materialized on a slow schedule since dimensions change rarely), and attaching it to facts via a saved or person join so its columns read as native fields. Key rule: for currency use the built-in convertCurrency() instead of a hand-rolled rate table. Read modeling-warehouse-foundations first; dimensions here are reused by the revenue, conversion, activation, and product-usage modeling skills.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"posthog","PostHog","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fposthog.png",[12,14,17,20],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Data Engineering","data-engineering",{"name":18,"slug":19,"type":13},"Data Warehouse","data-warehouse",{"name":21,"slug":22,"type":13},"Data Modeling","data-modeling",35568,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog","2026-08-06T06:09:31.408343",null,2977,[29,30,31,32,19,33,34,35,36,37,38,39,40,41,42],"ab-testing","ai-analytics","analytics","cdp","experiments","feature-flags","javascript","product-analytics","python","react","session-replay","surveys","typescript","web-analytics",{"repoUrl":24,"stars":23,"forks":27,"topics":44,"description":45},[29,30,31,32,19,33,34,35,36,37,38,39,40,41,42],"🦔 PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog\u002Ftree\u002FHEAD\u002Fproducts\u002Fdata_modeling\u002Fskills\u002Fmodeling-dimension-tables","---\nname: modeling-dimension-tables\ndescription: >\n  Build reusable dimension \u002F lookup tables for a star schema — country\u002Fregion, timezone, currency, date,\n  plan\u002Fproduct, and other descriptive attributes — on either PostHog data-warehouse views (HogQL) or an\n  external dbt project. Use when the user wants to model dimension tables, lookup tables, a star schema,\n  conformed dimensions, or wants to enrich events\u002Frevenue\u002Fusage with country, region, timezone, plan, or\n  currency attributes without repeating JOINs. Covers sourcing the dimension data (upload, warehouse source,\n  or derive from events), shaping it into an aliased one-row-per-entity view (optionally materialized on a\n  slow schedule since dimensions change rarely), and attaching it to facts via a saved or person join so its\n  columns read as native fields. Key rule: for currency use the built-in convertCurrency() instead of a\n  hand-rolled rate table. Read modeling-warehouse-foundations first; dimensions here are reused by the\n  revenue, conversion, activation, and product-usage modeling skills.\n---\n\n# Modeling dimension tables (star schema)\n\nDimensions are the descriptive tables (`dim_country`, `dim_plan`, `dim_date`) that fact tables join to for\nslicing. This skill builds them once, cleanly, so every other model reuses them instead of re-deriving\nlookups. Read `modeling-warehouse-foundations` first (joins + `convertCurrency()` live there). Catalog of\ncommon dimensions: [`references\u002Fdimension-catalog.md`](references\u002Fdimension-catalog.md); recipes in\n[`references\u002Fposthog\u002F`](references\u002Fposthog\u002F) and [`references\u002Fdbt\u002F`](references\u002Fdbt\u002F).\n\n## Star schema in one screen\n\n**Facts** (events, charges, revenue items) are long, keyed, and additive. **Dimensions** are short, one row\nper entity, descriptive. You model a dimension in three moves:\n\n1. **Source it** — where does the dimension data come from?\n   - _Upload \u002F seed_ a lookup (country→region, plan→tier) as a CSV (warehouse source or dbt seed).\n   - _Sync_ it from a system of record (your app DB, Stripe products) as a warehouse source.\n   - _Derive_ it from events (distinct countries seen, a plan property observed per person).\n2. **Shape it** — an **aliased** `SELECT` with clean column names, **one row per entity** (dedupe hard).\n   Save as a view; **materialize** it on a **slow** `sync_frequency` (`7day`\u002F`30day`) since dimensions change\n   rarely and are read constantly.\n3. **Attach it** — a **saved join** (dimension → a fact table) or **person join** (dimension → persons) so\n   its columns appear as native fields in any query, filter, or breakdown. See foundations\n   `joins-and-dimensions.md`.\n\n## Currency is already a managed dimension — don't build it\n\nPostHog ships exchange rates behind `convertCurrency(from, to, amount, timestamp?)` (Open Exchange Rates,\nhistorical-rate-correct). Use it directly for any money conversion. Only build a currency dimension yourself\nin **dbt** (which has no equivalent), or if you need a rate provider PostHog doesn't offer.\n\n## Rules before you model\n\n1. **One row per entity, unique key.** A dimension with duplicate keys silently fan-outs every fact it joins.\n   Test uniqueness (PostHog: verify in the shaping query; dbt: `unique` + `not_null`).\n2. **Alias to clean, stable names** — `country_code`, `region`, `plan_tier`. These names become the join\n   surface everything else depends on.\n3. **Materialize static dimensions on a slow schedule**; don't leave a constantly-read lookup virtual.\n4. **Register and certify.** Annotate the dimension and, if it's load-bearing, certify it in the catalog\n   (foundations `governance.md`) so other models discover it and don't build a rival copy.\n5. **Prefer built-in currency** (`convertCurrency`) over a hand-rolled FX table on PostHog.\n\n## Build it\n\n**PostHog:** shape an aliased dimension view, then materialize + join. Recipes:\n[`references\u002Fposthog\u002Fdim_country.sql`](references\u002Fposthog\u002Fdim_country.sql) (derive + enrich from events),\n[`dim_plan.sql`](references\u002Fposthog\u002Fdim_plan.sql) (lookup\u002Fupload pattern).\n\n**dbt:** conformed `dim_*` models with `unique`\u002F`not_null`\u002F`relationships` tests, plus a generated\n`dim_date`. Recipes: [`references\u002Fdbt\u002F`](references\u002Fdbt\u002F).\n\n## File map\n\n| File                                                                 | Read when                                                   |\n| -------------------------------------------------------------------- | ----------------------------------------------------------- |\n| [`references\u002Fdimension-catalog.md`](references\u002Fdimension-catalog.md) | Common dimensions, how to source each, and the natural key. |\n| [`references\u002Fposthog\u002F`](references\u002Fposthog\u002F)                         | HogQL aliased-dimension view recipes.                       |\n| [`references\u002Fdbt\u002F`](references\u002Fdbt\u002F)                                 | dbt `dim_date` \u002F `dim_country` + `schema.yml` tests.        |\n\n## Companions\n\n`modeling-warehouse-foundations` (joins + currency), `setting-up-a-data-warehouse-source` \u002F\n`suggesting-data-imports` (sync\u002Fupload the source data), and the models that consume these dimensions:\n`modeling-revenue-metrics`, `modeling-conversion-metrics`, `modeling-activation-metrics`,\n`modeling-product-usage-metrics`.\n",{"data":49,"body":50},{"name":4,"description":6},{"type":51,"children":52},"root",[53,62,142,149,167,317,323,343,349,455,461,494,548,554,660,666],{"type":54,"tag":55,"props":56,"children":58},"element","h1",{"id":57},"modeling-dimension-tables-star-schema",[59],{"type":60,"value":61},"text","Modeling dimension tables (star schema)",{"type":54,"tag":63,"props":64,"children":65},"p",{},[66,68,75,77,83,84,90,92,98,100,106,108,118,120,129,131,140],{"type":60,"value":67},"Dimensions are the descriptive tables (",{"type":54,"tag":69,"props":70,"children":72},"code",{"className":71},[],[73],{"type":60,"value":74},"dim_country",{"type":60,"value":76},", ",{"type":54,"tag":69,"props":78,"children":80},{"className":79},[],[81],{"type":60,"value":82},"dim_plan",{"type":60,"value":76},{"type":54,"tag":69,"props":85,"children":87},{"className":86},[],[88],{"type":60,"value":89},"dim_date",{"type":60,"value":91},") that fact tables join to for\nslicing. This skill builds them once, cleanly, so every other model reuses them instead of re-deriving\nlookups. Read ",{"type":54,"tag":69,"props":93,"children":95},{"className":94},[],[96],{"type":60,"value":97},"modeling-warehouse-foundations",{"type":60,"value":99}," first (joins + ",{"type":54,"tag":69,"props":101,"children":103},{"className":102},[],[104],{"type":60,"value":105},"convertCurrency()",{"type":60,"value":107}," live there). Catalog of\ncommon dimensions: ",{"type":54,"tag":109,"props":110,"children":112},"a",{"href":111},"references\u002Fdimension-catalog.md",[113],{"type":54,"tag":69,"props":114,"children":116},{"className":115},[],[117],{"type":60,"value":111},{"type":60,"value":119},"; recipes in\n",{"type":54,"tag":109,"props":121,"children":123},{"href":122},"references\u002Fposthog\u002F",[124],{"type":54,"tag":69,"props":125,"children":127},{"className":126},[],[128],{"type":60,"value":122},{"type":60,"value":130}," and ",{"type":54,"tag":109,"props":132,"children":134},{"href":133},"references\u002Fdbt\u002F",[135],{"type":54,"tag":69,"props":136,"children":138},{"className":137},[],[139],{"type":60,"value":133},{"type":60,"value":141},".",{"type":54,"tag":143,"props":144,"children":146},"h2",{"id":145},"star-schema-in-one-screen",[147],{"type":60,"value":148},"Star schema in one screen",{"type":54,"tag":63,"props":150,"children":151},{},[152,158,160,165],{"type":54,"tag":153,"props":154,"children":155},"strong",{},[156],{"type":60,"value":157},"Facts",{"type":60,"value":159}," (events, charges, revenue items) are long, keyed, and additive. ",{"type":54,"tag":153,"props":161,"children":162},{},[163],{"type":60,"value":164},"Dimensions",{"type":60,"value":166}," are short, one row\nper entity, descriptive. You model a dimension in three moves:",{"type":54,"tag":168,"props":169,"children":170},"ol",{},[171,217,286],{"type":54,"tag":172,"props":173,"children":174},"li",{},[175,180,182],{"type":54,"tag":153,"props":176,"children":177},{},[178],{"type":60,"value":179},"Source it",{"type":60,"value":181}," — where does the dimension data come from?\n",{"type":54,"tag":183,"props":184,"children":185},"ul",{},[186,197,207],{"type":54,"tag":172,"props":187,"children":188},{},[189,195],{"type":54,"tag":190,"props":191,"children":192},"em",{},[193],{"type":60,"value":194},"Upload \u002F seed",{"type":60,"value":196}," a lookup (country→region, plan→tier) as a CSV (warehouse source or dbt seed).",{"type":54,"tag":172,"props":198,"children":199},{},[200,205],{"type":54,"tag":190,"props":201,"children":202},{},[203],{"type":60,"value":204},"Sync",{"type":60,"value":206}," it from a system of record (your app DB, Stripe products) as a warehouse source.",{"type":54,"tag":172,"props":208,"children":209},{},[210,215],{"type":54,"tag":190,"props":211,"children":212},{},[213],{"type":60,"value":214},"Derive",{"type":60,"value":216}," it from events (distinct countries seen, a plan property observed per person).",{"type":54,"tag":172,"props":218,"children":219},{},[220,225,227,232,234,240,242,247,249,254,256,261,262,268,270,276,278,284],{"type":54,"tag":153,"props":221,"children":222},{},[223],{"type":60,"value":224},"Shape it",{"type":60,"value":226}," — an ",{"type":54,"tag":153,"props":228,"children":229},{},[230],{"type":60,"value":231},"aliased",{"type":60,"value":233}," ",{"type":54,"tag":69,"props":235,"children":237},{"className":236},[],[238],{"type":60,"value":239},"SELECT",{"type":60,"value":241}," with clean column names, ",{"type":54,"tag":153,"props":243,"children":244},{},[245],{"type":60,"value":246},"one row per entity",{"type":60,"value":248}," (dedupe hard).\nSave as a view; ",{"type":54,"tag":153,"props":250,"children":251},{},[252],{"type":60,"value":253},"materialize",{"type":60,"value":255}," it on a ",{"type":54,"tag":153,"props":257,"children":258},{},[259],{"type":60,"value":260},"slow",{"type":60,"value":233},{"type":54,"tag":69,"props":263,"children":265},{"className":264},[],[266],{"type":60,"value":267},"sync_frequency",{"type":60,"value":269}," (",{"type":54,"tag":69,"props":271,"children":273},{"className":272},[],[274],{"type":60,"value":275},"7day",{"type":60,"value":277},"\u002F",{"type":54,"tag":69,"props":279,"children":281},{"className":280},[],[282],{"type":60,"value":283},"30day",{"type":60,"value":285},") since dimensions change\nrarely and are read constantly.",{"type":54,"tag":172,"props":287,"children":288},{},[289,294,296,301,303,308,310,316],{"type":54,"tag":153,"props":290,"children":291},{},[292],{"type":60,"value":293},"Attach it",{"type":60,"value":295}," — a ",{"type":54,"tag":153,"props":297,"children":298},{},[299],{"type":60,"value":300},"saved join",{"type":60,"value":302}," (dimension → a fact table) or ",{"type":54,"tag":153,"props":304,"children":305},{},[306],{"type":60,"value":307},"person join",{"type":60,"value":309}," (dimension → persons) so\nits columns appear as native fields in any query, filter, or breakdown. See foundations\n",{"type":54,"tag":69,"props":311,"children":313},{"className":312},[],[314],{"type":60,"value":315},"joins-and-dimensions.md",{"type":60,"value":141},{"type":54,"tag":143,"props":318,"children":320},{"id":319},"currency-is-already-a-managed-dimension-dont-build-it",[321],{"type":60,"value":322},"Currency is already a managed dimension — don't build it",{"type":54,"tag":63,"props":324,"children":325},{},[326,328,334,336,341],{"type":60,"value":327},"PostHog ships exchange rates behind ",{"type":54,"tag":69,"props":329,"children":331},{"className":330},[],[332],{"type":60,"value":333},"convertCurrency(from, to, amount, timestamp?)",{"type":60,"value":335}," (Open Exchange Rates,\nhistorical-rate-correct). Use it directly for any money conversion. Only build a currency dimension yourself\nin ",{"type":54,"tag":153,"props":337,"children":338},{},[339],{"type":60,"value":340},"dbt",{"type":60,"value":342}," (which has no equivalent), or if you need a rate provider PostHog doesn't offer.",{"type":54,"tag":143,"props":344,"children":346},{"id":345},"rules-before-you-model",[347],{"type":60,"value":348},"Rules before you model",{"type":54,"tag":168,"props":350,"children":351},{},[352,378,410,420,438],{"type":54,"tag":172,"props":353,"children":354},{},[355,360,362,368,370,376],{"type":54,"tag":153,"props":356,"children":357},{},[358],{"type":60,"value":359},"One row per entity, unique key.",{"type":60,"value":361}," A dimension with duplicate keys silently fan-outs every fact it joins.\nTest uniqueness (PostHog: verify in the shaping query; dbt: ",{"type":54,"tag":69,"props":363,"children":365},{"className":364},[],[366],{"type":60,"value":367},"unique",{"type":60,"value":369}," + ",{"type":54,"tag":69,"props":371,"children":373},{"className":372},[],[374],{"type":60,"value":375},"not_null",{"type":60,"value":377},").",{"type":54,"tag":172,"props":379,"children":380},{},[381,386,388,394,395,401,402,408],{"type":54,"tag":153,"props":382,"children":383},{},[384],{"type":60,"value":385},"Alias to clean, stable names",{"type":60,"value":387}," — ",{"type":54,"tag":69,"props":389,"children":391},{"className":390},[],[392],{"type":60,"value":393},"country_code",{"type":60,"value":76},{"type":54,"tag":69,"props":396,"children":398},{"className":397},[],[399],{"type":60,"value":400},"region",{"type":60,"value":76},{"type":54,"tag":69,"props":403,"children":405},{"className":404},[],[406],{"type":60,"value":407},"plan_tier",{"type":60,"value":409},". These names become the join\nsurface everything else depends on.",{"type":54,"tag":172,"props":411,"children":412},{},[413,418],{"type":54,"tag":153,"props":414,"children":415},{},[416],{"type":60,"value":417},"Materialize static dimensions on a slow schedule",{"type":60,"value":419},"; don't leave a constantly-read lookup virtual.",{"type":54,"tag":172,"props":421,"children":422},{},[423,428,430,436],{"type":54,"tag":153,"props":424,"children":425},{},[426],{"type":60,"value":427},"Register and certify.",{"type":60,"value":429}," Annotate the dimension and, if it's load-bearing, certify it in the catalog\n(foundations ",{"type":54,"tag":69,"props":431,"children":433},{"className":432},[],[434],{"type":60,"value":435},"governance.md",{"type":60,"value":437},") so other models discover it and don't build a rival copy.",{"type":54,"tag":172,"props":439,"children":440},{},[441,446,447,453],{"type":54,"tag":153,"props":442,"children":443},{},[444],{"type":60,"value":445},"Prefer built-in currency",{"type":60,"value":269},{"type":54,"tag":69,"props":448,"children":450},{"className":449},[],[451],{"type":60,"value":452},"convertCurrency",{"type":60,"value":454},") over a hand-rolled FX table on PostHog.",{"type":54,"tag":143,"props":456,"children":458},{"id":457},"build-it",[459],{"type":60,"value":460},"Build it",{"type":54,"tag":63,"props":462,"children":463},{},[464,469,471,480,482,492],{"type":54,"tag":153,"props":465,"children":466},{},[467],{"type":60,"value":468},"PostHog:",{"type":60,"value":470}," shape an aliased dimension view, then materialize + join. Recipes:\n",{"type":54,"tag":109,"props":472,"children":474},{"href":473},"references\u002Fposthog\u002Fdim_country.sql",[475],{"type":54,"tag":69,"props":476,"children":478},{"className":477},[],[479],{"type":60,"value":473},{"type":60,"value":481}," (derive + enrich from events),\n",{"type":54,"tag":109,"props":483,"children":485},{"href":484},"references\u002Fposthog\u002Fdim_plan.sql",[486],{"type":54,"tag":69,"props":487,"children":489},{"className":488},[],[490],{"type":60,"value":491},"dim_plan.sql",{"type":60,"value":493}," (lookup\u002Fupload pattern).",{"type":54,"tag":63,"props":495,"children":496},{},[497,502,504,510,512,517,518,523,524,530,532,537,539,547],{"type":54,"tag":153,"props":498,"children":499},{},[500],{"type":60,"value":501},"dbt:",{"type":60,"value":503}," conformed ",{"type":54,"tag":69,"props":505,"children":507},{"className":506},[],[508],{"type":60,"value":509},"dim_*",{"type":60,"value":511}," models with ",{"type":54,"tag":69,"props":513,"children":515},{"className":514},[],[516],{"type":60,"value":367},{"type":60,"value":277},{"type":54,"tag":69,"props":519,"children":521},{"className":520},[],[522],{"type":60,"value":375},{"type":60,"value":277},{"type":54,"tag":69,"props":525,"children":527},{"className":526},[],[528],{"type":60,"value":529},"relationships",{"type":60,"value":531}," tests, plus a generated\n",{"type":54,"tag":69,"props":533,"children":535},{"className":534},[],[536],{"type":60,"value":89},{"type":60,"value":538},". Recipes: ",{"type":54,"tag":109,"props":540,"children":541},{"href":133},[542],{"type":54,"tag":69,"props":543,"children":545},{"className":544},[],[546],{"type":60,"value":133},{"type":60,"value":141},{"type":54,"tag":143,"props":549,"children":551},{"id":550},"file-map",[552],{"type":60,"value":553},"File map",{"type":54,"tag":555,"props":556,"children":557},"table",{},[558,577],{"type":54,"tag":559,"props":560,"children":561},"thead",{},[562],{"type":54,"tag":563,"props":564,"children":565},"tr",{},[566,572],{"type":54,"tag":567,"props":568,"children":569},"th",{},[570],{"type":60,"value":571},"File",{"type":54,"tag":567,"props":573,"children":574},{},[575],{"type":60,"value":576},"Read when",{"type":54,"tag":578,"props":579,"children":580},"tbody",{},[581,601,620],{"type":54,"tag":563,"props":582,"children":583},{},[584,596],{"type":54,"tag":585,"props":586,"children":587},"td",{},[588],{"type":54,"tag":109,"props":589,"children":590},{"href":111},[591],{"type":54,"tag":69,"props":592,"children":594},{"className":593},[],[595],{"type":60,"value":111},{"type":54,"tag":585,"props":597,"children":598},{},[599],{"type":60,"value":600},"Common dimensions, how to source each, and the natural key.",{"type":54,"tag":563,"props":602,"children":603},{},[604,615],{"type":54,"tag":585,"props":605,"children":606},{},[607],{"type":54,"tag":109,"props":608,"children":609},{"href":122},[610],{"type":54,"tag":69,"props":611,"children":613},{"className":612},[],[614],{"type":60,"value":122},{"type":54,"tag":585,"props":616,"children":617},{},[618],{"type":60,"value":619},"HogQL aliased-dimension view recipes.",{"type":54,"tag":563,"props":621,"children":622},{},[623,634],{"type":54,"tag":585,"props":624,"children":625},{},[626],{"type":54,"tag":109,"props":627,"children":628},{"href":133},[629],{"type":54,"tag":69,"props":630,"children":632},{"className":631},[],[633],{"type":60,"value":133},{"type":54,"tag":585,"props":635,"children":636},{},[637,639,644,646,651,652,658],{"type":60,"value":638},"dbt ",{"type":54,"tag":69,"props":640,"children":642},{"className":641},[],[643],{"type":60,"value":89},{"type":60,"value":645}," \u002F ",{"type":54,"tag":69,"props":647,"children":649},{"className":648},[],[650],{"type":60,"value":74},{"type":60,"value":369},{"type":54,"tag":69,"props":653,"children":655},{"className":654},[],[656],{"type":60,"value":657},"schema.yml",{"type":60,"value":659}," tests.",{"type":54,"tag":143,"props":661,"children":663},{"id":662},"companions",[664],{"type":60,"value":665},"Companions",{"type":54,"tag":63,"props":667,"children":668},{},[669,674,676,682,684,690,692,698,699,705,706,712,714,720],{"type":54,"tag":69,"props":670,"children":672},{"className":671},[],[673],{"type":60,"value":97},{"type":60,"value":675}," (joins + currency), ",{"type":54,"tag":69,"props":677,"children":679},{"className":678},[],[680],{"type":60,"value":681},"setting-up-a-data-warehouse-source",{"type":60,"value":683}," \u002F\n",{"type":54,"tag":69,"props":685,"children":687},{"className":686},[],[688],{"type":60,"value":689},"suggesting-data-imports",{"type":60,"value":691}," (sync\u002Fupload the source data), and the models that consume these dimensions:\n",{"type":54,"tag":69,"props":693,"children":695},{"className":694},[],[696],{"type":60,"value":697},"modeling-revenue-metrics",{"type":60,"value":76},{"type":54,"tag":69,"props":700,"children":702},{"className":701},[],[703],{"type":60,"value":704},"modeling-conversion-metrics",{"type":60,"value":76},{"type":54,"tag":69,"props":707,"children":709},{"className":708},[],[710],{"type":60,"value":711},"modeling-activation-metrics",{"type":60,"value":713},",\n",{"type":54,"tag":69,"props":715,"children":717},{"className":716},[],[718],{"type":60,"value":719},"modeling-product-usage-metrics",{"type":60,"value":141},{"items":722,"total":899},[723,739,751,762,775,790,806,823,841,857,872,884],{"slug":724,"name":724,"fn":725,"description":726,"org":727,"tags":728,"stars":23,"repoUrl":24,"updatedAt":738},"analyzing-expensive-users","analyze expensive users in AI observability","Analyze the most expensive users in AI observability and explain why they cost so much. Use when the user asks about top spenders, expensive users, per-user LLM cost, user-level cost drivers, or patterns behind high AI observability spend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[729,731,734,737],{"name":730,"slug":31,"type":13},"Analytics",{"name":732,"slug":733,"type":13},"Cost Optimization","cost-optimization",{"name":735,"slug":736,"type":13},"Observability","observability",{"name":9,"slug":8,"type":13},"2026-07-28T05:34:11.117757",{"slug":740,"name":740,"fn":741,"description":742,"org":743,"tags":744,"stars":23,"repoUrl":24,"updatedAt":750},"auditing-endpoints","audit PostHog project endpoints","Audit every endpoint in a PostHog project for staleness, failed materialisations, and unused materialised versions. Use when the user asks \"what endpoints can I clean up?\", \"are any of my endpoints broken?\", \"which materialised versions are still being called?\", or wants a one-shot cleanup pass over the Endpoints product. Produces a prioritised report grouped by issue type, with recommended actions but does not modify anything without explicit confirmation.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[745,746,749],{"name":730,"slug":31,"type":13},{"name":747,"slug":748,"type":13},"Audit","audit",{"name":9,"slug":8,"type":13},"2026-06-08T08:08:33.693989",{"slug":752,"name":752,"fn":753,"description":754,"org":755,"tags":756,"stars":23,"repoUrl":24,"updatedAt":761},"auditing-warehouse-source-health","audit PostHog data warehouse source health","Audit the health of a PostHog project's data warehouse sources and syncs — find every broken or degraded source connection, sync schema, and webhook channel. Use when the user asks \"why are my imports failing?\", \"what's broken with my sources?\", \"why is my warehouse data stale?\", or wants a one-shot triage of source\u002Fsync health before deciding where to dig in. Produces a prioritized report grouped by severity, with recommended next steps. For materialized-view health use `auditing-warehouse-view-health`; for a single failing sync use `diagnosing-failed-warehouse-syncs`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[757,758,759,760],{"name":747,"slug":748,"type":13},{"name":18,"slug":19,"type":13},{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},"2026-06-18T08:22:57.67984",{"slug":763,"name":763,"fn":764,"description":765,"org":766,"tags":767,"stars":23,"repoUrl":24,"updatedAt":774},"auditing-warehouse-view-health","audit PostHog materialized view health","Audit the health of a PostHog project's materialized views (saved queries) — find every failed materialization and flag unused or stale materialized views that cost storage and compute. Use when the user asks \"which of my views are broken?\", \"why is this materialized view failing?\", \"are any of my views wasting compute?\", or wants a one-shot triage of view health. For source\u002Fsync health use `auditing-warehouse-source-health`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[768,769,770,773],{"name":747,"slug":748,"type":13},{"name":18,"slug":19,"type":13},{"name":771,"slug":772,"type":13},"Performance","performance",{"name":9,"slug":8,"type":13},"2026-06-18T08:25:10.936787",{"slug":776,"name":776,"fn":777,"description":778,"org":779,"tags":780,"stars":23,"repoUrl":24,"updatedAt":789},"authoring-error-tracking-alerts","author PostHog error tracking alerts","Author error tracking alerts that fire when an issue is created, reopened, or starts spiking. Use when the user asks to set up error notifications, route exceptions to Slack\u002Fwebhook\u002FLinear, or evaluate which error events are worth alerting on. Covers trigger-event selection, integration choice, dedup against existing alerts, and shipping with the canonical message body shape.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[781,784,787,788],{"name":782,"slug":783,"type":13},"Alerting","alerting",{"name":785,"slug":786,"type":13},"Debugging","debugging",{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},"2026-06-18T08:24:40.318583",{"slug":791,"name":791,"fn":792,"description":793,"org":794,"tags":795,"stars":23,"repoUrl":24,"updatedAt":805},"authoring-log-alerts","author log alerts in PostHog","Author useful, low-noise log alerts on services in a PostHog project. Use when the user asks to set up alerts for their logs, suggest alerts they should add, or evaluate whether a service is worth monitoring. Covers service triage, baseline characterisation, threshold drafting, back-testing via simulate, and shipping with a notification destination.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[796,797,800,801,804],{"name":730,"slug":31,"type":13},{"name":798,"slug":799,"type":13},"Monitoring","monitoring",{"name":735,"slug":736,"type":13},{"name":802,"slug":803,"type":13},"Operations","operations",{"name":9,"slug":8,"type":13},"2026-07-18T05:10:54.430898",{"slug":807,"name":807,"fn":808,"description":809,"org":810,"tags":811,"stars":23,"repoUrl":24,"updatedAt":822},"building-canvases","create and edit PostHog canvases","Create or edit a PostHog canvas — a sandboxed browser application (data board, document, form, small tool, graphics experiment) stored in PostHog and rendered by the desktop\u002Fweb app. Use when a task asks to build, generate, update, or fix a canvas, or when a canvas id is given as the publish target. Covers resolving or creating the target canvas, choosing an implementation approach (React + Quill vs plain HTML\u002Fbrowser APIs), the read → edit → validate → publish → build loop, and which companion canvas skills to load for the details.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[812,815,818,819],{"name":813,"slug":814,"type":13},"Automation","automation",{"name":816,"slug":817,"type":13},"Design","design",{"name":9,"slug":8,"type":13},{"name":820,"slug":821,"type":13},"Prototyping","prototyping","2026-08-06T06:09:29.946969",{"slug":824,"name":824,"fn":825,"description":826,"org":827,"tags":828,"stars":23,"repoUrl":24,"updatedAt":840},"building-html-canvases","author HTML and CSS PostHog canvases","Author a PostHog canvas with semantic HTML, CSS, and direct browser APIs — documents, articles, generative graphics, 2D canvas and WebGL experiences, and focused experiments where React components add no useful structure. Use after building-canvases has routed a canvas request to a plain-HTML\u002Fbrowser-API implementation. Covers the thin component wrapper the current runtime requires, styling and theming without Quill, drawing surfaces, and animation\u002Fcleanup patterns.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[829,832,833,836,839],{"name":830,"slug":831,"type":13},"CSS","css",{"name":816,"slug":817,"type":13},{"name":834,"slug":835,"type":13},"Graphics","graphics",{"name":837,"slug":838,"type":13},"HTML","html",{"name":9,"slug":8,"type":13},"2026-08-06T06:09:30.313848",{"slug":842,"name":842,"fn":843,"description":844,"org":845,"tags":846,"stars":23,"repoUrl":24,"updatedAt":856},"building-react-quill-canvases","build React and Quill canvases","Author the React + Quill implementation of a PostHog canvas: the single-component contract, the allowed imports, Quill (PostHog's design system) component and composition rules, theme-aware design tokens, loading skeletons, and the in-canvas date picker. Use after building-canvases has routed a canvas request to a React implementation — dashboards, data boards, forms, tools, or any canvas that should look native to PostHog.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[847,848,851,853],{"name":816,"slug":817,"type":13},{"name":849,"slug":850,"type":13},"Frontend","frontend",{"name":852,"slug":38,"type":13},"React",{"name":854,"slug":855,"type":13},"UI Components","ui-components","2026-08-06T06:09:18.633724",{"slug":858,"name":858,"fn":859,"description":860,"org":861,"tags":862,"stars":23,"repoUrl":24,"updatedAt":871},"building-workflows","build and edit PostHog workflows","Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action\u002Fedge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence, or event-triggered automation in the workflows product.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[863,864,867,868],{"name":813,"slug":814,"type":13},{"name":865,"slug":866,"type":13},"MCP","mcp",{"name":9,"slug":8,"type":13},{"name":869,"slug":870,"type":13},"Workflow Automation","workflow-automation","2026-08-06T05:36:26.504811",{"slug":873,"name":873,"fn":874,"description":875,"org":876,"tags":877,"stars":23,"repoUrl":24,"updatedAt":883},"check-posthog-loading","inspect PostHog SDK loading across URLs","Inspect how the PostHog JavaScript SDK is loaded across a list of URLs. Use to confirm consistent installation across pages, find pages missing the snippet, detect mismatched API keys or hosts between pages, and verify the load method (head snippet vs deferred vs array.js).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[878,879,880,881,882],{"name":730,"slug":31,"type":13},{"name":785,"slug":786,"type":13},{"name":849,"slug":850,"type":13},{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},"2026-05-07T05:56:19.828048",{"slug":885,"name":885,"fn":886,"description":887,"org":888,"tags":889,"stars":23,"repoUrl":24,"updatedAt":898},"consuming-endpoints-from-client-code","integrate PostHog endpoints into client applications","Wire a PostHog endpoint into a client app or SDK. Covers fetching the OpenAPI spec, generating a typed client with openapi-generator or @hey-api\u002Fopenapi-ts, sending the right auth header, shaping the variables payload (HogQL code_name vs insight breakdown property), handling rate-limit and materialised-endpoint error responses. Use when the user says \"how do I call my endpoint\", \"generate a client for this\", or \"what auth header do I use\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[890,893,894,895],{"name":891,"slug":892,"type":13},"API Development","api-development",{"name":849,"slug":850,"type":13},{"name":9,"slug":8,"type":13},{"name":896,"slug":897,"type":13},"SDK","sdk","2026-06-08T08:08:34.929454",243,{"items":901,"total":951},[902,909,915,922,929,936,944],{"slug":724,"name":724,"fn":725,"description":726,"org":903,"tags":904,"stars":23,"repoUrl":24,"updatedAt":738},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[905,906,907,908],{"name":730,"slug":31,"type":13},{"name":732,"slug":733,"type":13},{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},{"slug":740,"name":740,"fn":741,"description":742,"org":910,"tags":911,"stars":23,"repoUrl":24,"updatedAt":750},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[912,913,914],{"name":730,"slug":31,"type":13},{"name":747,"slug":748,"type":13},{"name":9,"slug":8,"type":13},{"slug":752,"name":752,"fn":753,"description":754,"org":916,"tags":917,"stars":23,"repoUrl":24,"updatedAt":761},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[918,919,920,921],{"name":747,"slug":748,"type":13},{"name":18,"slug":19,"type":13},{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},{"slug":763,"name":763,"fn":764,"description":765,"org":923,"tags":924,"stars":23,"repoUrl":24,"updatedAt":774},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[925,926,927,928],{"name":747,"slug":748,"type":13},{"name":18,"slug":19,"type":13},{"name":771,"slug":772,"type":13},{"name":9,"slug":8,"type":13},{"slug":776,"name":776,"fn":777,"description":778,"org":930,"tags":931,"stars":23,"repoUrl":24,"updatedAt":789},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[932,933,934,935],{"name":782,"slug":783,"type":13},{"name":785,"slug":786,"type":13},{"name":735,"slug":736,"type":13},{"name":9,"slug":8,"type":13},{"slug":791,"name":791,"fn":792,"description":793,"org":937,"tags":938,"stars":23,"repoUrl":24,"updatedAt":805},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[939,940,941,942,943],{"name":730,"slug":31,"type":13},{"name":798,"slug":799,"type":13},{"name":735,"slug":736,"type":13},{"name":802,"slug":803,"type":13},{"name":9,"slug":8,"type":13},{"slug":807,"name":807,"fn":808,"description":809,"org":945,"tags":946,"stars":23,"repoUrl":24,"updatedAt":822},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[947,948,949,950],{"name":813,"slug":814,"type":13},{"name":816,"slug":817,"type":13},{"name":9,"slug":8,"type":13},{"name":820,"slug":821,"type":13},74]