Merge pull request #162 from rajbos/copilot/add-agent-skill-load-table-data

Add azure-storage-loader skill for querying token usage data from Azure Tables

Author: rajbos

.github/skills/README.md

@@ -14,6 +14,25 @@ Agent Skills are directories containing a `SKILL.md` file and optional supportin
 
 ## Available Skills
 
+### azure-storage-loader
+
+**Purpose**: Load token usage data from Azure Table Storage for faster iteration and analysis.
+
+**Use this skill when:**
+- Analyzing actual usage data without manual export
+- Testing query logic against real backend data
+- Debugging backend sync issues with live data
+- Performing ad-hoc team analytics
+- Quickly iterating on data analysis tasks in chat
+
+**Contents:**
+- Helper script to fetch data from Azure Storage Tables
+- Support for both Entra ID and Shared Key authentication
+- Flexible filtering by date, model, workspace, or user
+- JSON and CSV output formats
+- Azure Table Storage schema documentation
+- Authentication and troubleshooting guides
+
 ### copilot-log-analysis
 
 **Purpose**: Comprehensive guide for analyzing GitHub Copilot session log files.
@@ -32,6 +51,16 @@ Agent Skills are directories containing a `SKILL.md` file and optional supportin
 - Schema documentation references
 - Usage examples and troubleshooting guides
 
+### refresh-json-data
+
+**Purpose**: Update token estimator and model pricing JSON files with latest data.
+
+**Use this skill when:**
+- Adding support for new AI models
+- Updating token estimation ratios
+- Refreshing pricing information from provider APIs
+- Keeping model data current with latest releases
+
 ### load-cache-data
 
 **Purpose**: Load and inspect the last 10 rows from the local session file cache to iterate with real data.

.github/skills/azure-storage-loader/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+package-lock.json
+*.log
+*.json.tmp
+*.csv.tmp

.github/skills/azure-storage-loader/README.md

@@ -0,0 +1,69 @@
+# Azure Storage Loader Skill
+
+Load token usage data from Azure Table Storage for analysis in chat conversations.
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Load data (using Entra ID auth)
+node load-table-data.js \
+  --storageAccount "youraccount" \
+  --tableName "usageAggDaily" \
+  --datasetId "default" \
+  --startDate "2026-01-01" \
+  --endDate "2026-01-30"
+
+# Output to file
+node load-table-data.js \
+  --storageAccount "youraccount" \
+  --startDate "2026-01-01" \
+  --endDate "2026-01-30" \
+  --output "usage-data.json"
+
+# Get help
+node load-table-data.js --help
+```
+
+## Files
+
+- **SKILL.md**: Complete skill documentation with examples and troubleshooting
+- **load-table-data.js**: Helper script to fetch data from Azure Storage Tables
+- **example-usage.js**: Example script demonstrating data loading and analysis
+- **package.json**: Node.js dependencies
+
+## Authentication
+
+### Entra ID (Default)
+Authenticate using one of these methods:
+- Azure CLI: `az login`
+- VS Code: Sign in via Azure extension
+- Environment variables
+
+### Shared Key
+Use `--sharedKey` parameter to provide storage account key.
+
+## Common Use Cases
+
+1. **Quick Analysis**: Load recent data for ad-hoc queries
+2. **Model Comparison**: Compare token usage across different AI models
+3. **Team Analytics**: Analyze per-user or per-workspace usage
+4. **Cost Estimation**: Calculate usage costs with pricing data
+
+## Documentation
+
+See **SKILL.md** for:
+- Complete parameter reference
+- Azure Table Storage schema details
+- Authentication setup
+- Advanced filtering examples
+- Troubleshooting guide
+- Security best practices
+
+## Requirements
+
+- Node.js 14 or later
+- Azure Storage account with token usage data
+- Appropriate Azure permissions (Storage Table Data Reader or Contributor)