Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .github/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
Expand Down
5 changes: 5 additions & 0 deletions .github/skills/azure-storage-loader/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
node_modules/
package-lock.json
*.log
*.json.tmp
*.csv.tmp
69 changes: 69 additions & 0 deletions .github/skills/azure-storage-loader/README.md
Original file line number Diff line number Diff line change
@@ -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)
Loading
Loading