lint

Author: max-ostapenko

.agents/skills/add-httparchive-metric-report/SKILL.md

@@ -8,6 +8,7 @@ description: Add new metrics to HTTPArchive reports config. USE FOR adding perfo
 ## Documentation
 
 **See [reports.md](../../../reports.md)** for complete guide including:
+
 - Architecture and processing details
 - Quick Decision Guide table
 - Required SQL patterns checklist
@@ -35,18 +36,19 @@ description: Add new metrics to HTTPArchive reports config. USE FOR adding perfo
 metricName: {
   SQL: [
     {
-      type: 'timeseries',  // or 'histogram'
-      query: DataformTemplateBuilder.create((ctx, params) => `
+      type: "timeseries", // or 'histogram'
+      query: DataformTemplateBuilder.create(
+        (ctx, params) => `
         SELECT client, /* your calculations */
-        FROM ${ctx.ref('crawl', 'pages')}
+        FROM ${ctx.ref("crawl", "pages")}
         WHERE date = '${params.date}' AND is_root_page
           ${params.lens.sql} ${params.devRankFilter}
         GROUP BY client ORDER BY client
-      `)
-    }
-  ]
+      `,
+      ),
+    },
+  ];
 }
 ```
 
 See [reports.md](../../../reports.md) for complete patterns and examples.
-

.agents/skills/optimize-model-compute/SKILL.md

@@ -21,27 +21,26 @@ Automatically assign Dataform actions to BigQuery slot reservations based on pri
 Reservations are configured in `definitions/_reservations.js`:
 
 ```javascript
-const { autoAssignActions } = require('@masthead-data/dataform-package')
+const { autoAssignActions } = require("@masthead-data/dataform-package");
 
 const RESERVATION_CONFIG = [
   {
-    tag: 'reservation',                    // Human-readable identifier
-    reservation: 'projects/.../reservations/...', // BigQuery reservation path
-    actions: [                             // Models assigned to this tier
-      'httparchive.crawl.pages',
-      'httparchive.f1.pages_latest'
-    ]
+    tag: "reservation", // Human-readable identifier
+    reservation: "projects/.../reservations/...", // BigQuery reservation path
+    actions: [
+      // Models assigned to this tier
+      "httparchive.crawl.pages",
+      "httparchive.f1.pages_latest",
+    ],
   },
   {
-    tag: 'on_demand',
-    reservation: 'none',                   // On-demand pricing
-    actions: [
-      'httparchive.sample_data.pages_10k'
-    ]
-  }
-]
+    tag: "on_demand",
+    reservation: "none", // On-demand pricing
+    actions: ["httparchive.sample_data.pages_10k"],
+  },
+];
 
-autoAssignActions(RESERVATION_CONFIG)
+autoAssignActions(RESERVATION_CONFIG);
 ```
 
 ## Implementation Steps
@@ -54,8 +53,9 @@ autoAssignActions(RESERVATION_CONFIG)
 
 1. Open `definitions/_reservations.js`
 2. Add or move actions between reservation tiers:
-   - **Reserved slots** (`reservation: 'projects/...'`): Critical, high-priority, SLA-sensitive workloads
-   - **On-demand** (`reservation: 'none'`): Low-priority, ad-hoc, or experimental workloads
+
+- **Reserved slots** (`reservation: 'projects/...'`): Critical, high-priority, SLA-sensitive workloads
+- **On-demand** (`reservation: 'none'`): Low-priority, ad-hoc, or experimental workloads
 
 ### Step 3: Verify Changes
 
@@ -69,12 +69,12 @@ grep -r "\.actions" definitions/_reservations.js
 
 ## Decision Criteria
 
-| Factor | Reserved Slots | On-Demand |
-|--------|----------------|-----------|
-| **Priority** | High, SLA-bound | Low, flexible |
-| **Frequency** | Regular, scheduled | Ad-hoc, occasional |
-| **Cost Pattern** | Predictable usage | Variable, sporadic |
-| **Impact** | Critical pipelines | Experimental, samples |
+| Factor           | Reserved Slots     | On-Demand             |
+| ---------------- | ------------------ | --------------------- |
+| **Priority**     | High, SLA-bound    | Low, flexible         |
+| **Frequency**    | Regular, scheduled | Ad-hoc, occasional    |
+| **Cost Pattern** | Predictable usage  | Variable, sporadic    |
+| **Impact**       | Critical pipelines | Experimental, samples |
 
 ## Key Notes
 

.agents/skills/optimize-storage-costs/SKILL.md

@@ -13,12 +13,13 @@ Identify and remove BigQuery tables that contribute to storage costs but have no
 
 Masthead Data uses lineage analysis to identify tables, but relies on visible pipeline references. Modification timestamps are critical:
 
-| Type | Definition | Indicators | Watch for |
-|------|------------|------------|---|
-| **Dead-end** | Regularly updated, no downstream consumption | Updated but never read in 30+ days | External writers outside lineage graph (manual jobs, independent pipelines) |
-| **Unused** | No upstream or downstream activity | No reads/writes in 30+ days | Recent `lastModifiedTime` despite "Unused" flag suggests external writer—**do not drop without verification** |
+| Type         | Definition                                   | Indicators                         | Watch for                                                                                                     |
+| ------------ | -------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| **Dead-end** | Regularly updated, no downstream consumption | Updated but never read in 30+ days | External writers outside lineage graph (manual jobs, independent pipelines)                                   |
+| **Unused**   | No upstream or downstream activity           | No reads/writes in 30+ days        | Recent `lastModifiedTime` despite "Unused" flag suggests external writer—**do not drop without verification** |
 
 ### Key Signal
+
 If a table is flagged `Unused` **and** has a recent modification timestamp, something outside Masthead's visibility is writing to it. This always warrants investigation before dropping.
 
 ## When to Use
@@ -60,18 +61,21 @@ ORDER BY savings_usd_30d DESC" > storage_waste.csv
 **Note:** Sorting by `savings_usd_30d` instead of `total_tib` prioritizes high-impact targets for review.
 
 **Alternative: Use Masthead UI**
+
 - Navigate to [Dictionary page](https://app.mastheadata.com/dictionary?tab=Tables&deadEnd=true)
 - Filter by `Dead-end` or `Unused` labels
 - Export table list for review
 
 ### Step 2: Review and Decide
 
 Review `storage_waste.csv` and add a `status` column with values:
+
 - `keep` - Table is needed
 - `to drop` - Safe to remove
 - `investigate` - Needs further analysis
 
 **Review criteria:**
+
 - Is this a backup or archive table? (consider alternative storage)
 - Is there a downstream dependency not captured in lineage?
 - Is this table part of an active experiment or migration?
@@ -94,6 +98,7 @@ bash drop_tables.sh
 ```
 
 **Safe mode (dry-run first):**
+
 ```bash
 # Add --dry-run flag to each command
 sed 's/bq rm/bq rm --dry-run/' drop_tables.sh > drop_tables_dryrun.sh
@@ -103,17 +108,18 @@ bash drop_tables_dryrun.sh
 ### Step 4: Verify Savings
 
 After 24-48 hours, check storage reduction in Masthead:
+
 - [Storage Cost Insights](https://app.mastheadata.com/costs?tab=Storage+costs)
 - Compare before/after storage size and costs
 
 ## Decision Framework
 
-| Monthly Savings | Action | Recency Check |
-|-----------------|--------|---------------|
-| < $10 | Consider keeping (low ROI) | Skip if `lastModifiedTime` > 12 months old (hygiene only) |
-| $10-$100 | Review and drop if unused | Check modification date; recent writes require owner verification |
-| $100-$1000 | Priority review, likely drop | Mandatory verification if modified in last 30 days |
-| > $1000 | Immediate investigation required | Always verify external writer before any action |
+| Monthly Savings | Action                           | Recency Check                                                     |
+| --------------- | -------------------------------- | ----------------------------------------------------------------- |
+| < $10           | Consider keeping (low ROI)       | Skip if `lastModifiedTime` > 12 months old (hygiene only)         |
+| $10-$100        | Review and drop if unused        | Check modification date; recent writes require owner verification |
+| $100-$1000      | Priority review, likely drop     | Mandatory verification if modified in last 30 days                |
+| > $1000         | Immediate investigation required | Always verify external writer before any action                   |
 
 ## Key Notes