docs(skill): add CIP starter query reference pack

Author: clavery

skills/b2c-cli/skills/b2c-cip/SKILL.md

@@ -74,6 +74,10 @@ For an efficient table catalog grouped by aggregate/dimension/fact families, use
 
 - `references/KNOWN_TABLES.md`
 
+For a general-purpose starter query pack with ready-to-run SQL patterns, use:
+
+- `references/STARTER_QUERIES.md`
+
 The list is derived from official JDBC documentation and intended as a quick discovery aid.
 
 ## Curated Report Examples

skills/b2c-cli/skills/b2c-cip/references/STARTER_QUERIES.md

@@ -0,0 +1,137 @@
+# CIP Starter Queries
+
+Use these as general-purpose starting points for exploration and troubleshooting.
+
+Defaults used in examples:
+
+- `siteId`: `Sites-RefArch-Site`
+- keep `LIMIT` clauses to stay lightweight
+
+## 1) Recent Daily Sales Snapshot
+
+```sql
+SELECT submit_date, num_orders, std_revenue, std_tax, std_shipping
+FROM ccdw_aggr_sales_summary
+ORDER BY submit_date DESC
+LIMIT 20
+```
+
+## 2) Sales by Site (Joined)
+
+```sql
+SELECT ss.submit_date, ds.nsite_id, SUM(ss.num_orders) AS orders, SUM(ss.std_revenue) AS revenue
+FROM ccdw_aggr_sales_summary ss
+JOIN ccdw_dim_site ds ON ss.site_id = ds.site_id
+WHERE ds.nsite_id = 'Sites-RefArch-Site'
+GROUP BY ss.submit_date, ds.nsite_id
+ORDER BY ss.submit_date DESC
+LIMIT 30
+```
+
+## 3) Top-Selling Products by Revenue
+
+```sql
+SELECT p.nproduct_id, p.product_display_name, SUM(pss.std_revenue) AS revenue, SUM(pss.num_units) AS units
+FROM ccdw_aggr_product_sales_summary pss
+JOIN ccdw_dim_product p ON p.product_id = pss.product_id
+JOIN ccdw_dim_site s ON s.site_id = pss.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY p.nproduct_id, p.product_display_name
+ORDER BY revenue DESC
+LIMIT 25
+```
+
+## 4) Promotion Impact Summary
+
+```sql
+SELECT p.promotion_class, SUM(pss.std_revenue) AS revenue, SUM(pss.std_total_discount) AS discount
+FROM ccdw_aggr_promotion_sales_summary pss
+JOIN ccdw_dim_promotion p ON p.promotion_id = pss.promotion_id
+JOIN ccdw_dim_site s ON s.site_id = pss.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY p.promotion_class
+ORDER BY revenue DESC
+LIMIT 20
+```
+
+## 5) OCAPI Request Volume
+
+```sql
+SELECT request_date, api_name, api_resource, SUM(num_requests) AS total_requests, SUM(response_time) AS total_response_time
+FROM ccdw_aggr_ocapi_request
+GROUP BY request_date, api_name, api_resource
+ORDER BY request_date DESC, total_requests DESC
+LIMIT 25
+```
+
+## 6) SCAPI Request Volume
+
+```sql
+SELECT request_date, api_name, api_resource, SUM(num_requests) AS total_requests, SUM(response_time) AS total_response_time
+FROM ccdw_aggr_scapi_request
+GROUP BY request_date, api_name, api_resource
+ORDER BY request_date DESC, total_requests DESC
+LIMIT 25
+```
+
+## 7) Top Search Terms by Revenue
+
+```sql
+SELECT LOWER(sc.query) AS search_term, SUM(sc.num_searches) AS searches, SUM(sc.num_orders) AS orders, SUM(sc.std_revenue) AS revenue
+FROM ccdw_aggr_search_conversion sc
+JOIN ccdw_dim_site s ON s.site_id = sc.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY LOWER(sc.query)
+ORDER BY revenue DESC
+LIMIT 30
+```
+
+## 8) Referrer Mix
+
+```sql
+SELECT referrer_medium, referrer_source, SUM(num_visits) AS visits
+FROM ccdw_aggr_visit_referrer vr
+JOIN ccdw_dim_site s ON s.site_id = vr.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY referrer_medium, referrer_source
+ORDER BY visits DESC
+LIMIT 30
+```
+
+## 9) Customer Registration Trend
+
+```sql
+SELECT registration_date, SUM(num_registrations) AS registrations
+FROM ccdw_aggr_registration r
+JOIN ccdw_dim_site s ON s.site_id = r.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY registration_date
+ORDER BY registration_date DESC
+LIMIT 30
+```
+
+## 10) Payment Method Performance
+
+```sql
+SELECT pm.display_name AS payment_method, SUM(pss.num_payments) AS payments, SUM(pss.std_captured_amount) AS captured_amount
+FROM ccdw_aggr_payment_sales_summary pss
+JOIN ccdw_dim_payment_method pm ON pm.payment_method_id = pss.payment_method_id
+JOIN ccdw_dim_site s ON s.site_id = pss.site_id
+WHERE s.nsite_id = 'Sites-RefArch-Site'
+GROUP BY pm.display_name
+ORDER BY captured_amount DESC
+LIMIT 20
+```
+
+## Placeholder Pattern for Date Windows
+
+Use this pattern when running with `b2c cip query --from ... --to ...`:
+
+```sql
+SELECT submit_date, num_orders, std_revenue
+FROM ccdw_aggr_sales_summary
+WHERE submit_date >= '<FROM>'
+  AND submit_date <= '<TO>'
+ORDER BY submit_date DESC
+LIMIT 20
+```