Add Claude Code plugin for FinOps hubs and Azure Cost Management

.claude-plugin/marketplace.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "finops-toolkit",
+  "description": "Microsoft FinOps Toolkit plugins for AI-powered cloud financial management.",
+  "owner": {
+    "name": "Microsoft"
+  },
+  "plugins": [
+    {
+      "name": "microsoft-finops-toolkit",
+      "version": "1.0.0",
+      "source": "../src/templates/claude-plugin",
+      "description": "AI-powered cloud financial management for Azure. Analyze costs with KQL queries against FinOps hubs, get CFO-level reporting, and access Azure Cost Management insights.",
+      "category": "productivity",
+      "homepage": "https://learn.microsoft.com/en-us/cloud-computing/finops/toolkit/finops-toolkit-overview"
+    },
+    {
+      "name": "microsoft-learn",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/microsoftdocs/mcp.git"
+      },
+      "description": "Access official Microsoft documentation, API references, and code samples for Azure, .NET, Windows, and more.",
+      "category": "documentation",
+      "homepage": "https://learn.microsoft.com"
+    }
+  ]
+}

AGENTS.md

@@ -0,0 +1 @@
+.github/copilot-instructions.md

CLAUDE.md

@@ -0,0 +1 @@
+.github/copilot-instructions.md

docs-mslearn/toolkit/changelog.md

@@ -3,7 +3,7 @@ title: FinOps toolkit changelog
 description: Review the latest features and enhancements in the FinOps toolkit, including updates to FinOps hubs, Power BI reports, and more.
 author: MSBrett
 ms.author: brettwil
-ms.date: 02/11/2026
+ms.date: 02/23/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -35,6 +35,13 @@ The following section lists features and enhancements that are currently in deve
 
 ## v14
 
+### Claude Code plugin v1.0
+
+- **Added**
+  - Added Claude Code plugin with skills for FinOps hubs and Azure Cost Management.
+  - Added 4 agents (CFO, FinOps practitioner, database query, hubs agent), 4 commands, and an output style.
+  - Moved KQL query catalog from `src/queries/` into the plugin.
+
 ### [FinOps hubs](hubs/finops-hubs-overview.md) v14
 
 - **Fixed**

src/queries/catalog/costs-enriched-base.kql

@@ -28,7 +28,7 @@
 //   for FinOps reporting, allocation, and optimization.
 //
 // For full schema and column definitions, see:
-//   https://raw.githubusercontent.com/microsoft/finops-toolkit/refs/heads/msbrett/features/ghc/src/queries/finops-hub-database-guide.md#column-definitions
+//   See finops-hub-database-guide.md#column-definitions in the queries reference directory
 // ============================================================================
 
 let startDate = startofmonth(ago(30d));

src/queries/catalog/quarterly-cost-by-resource-group.kql

@@ -1,15 +1,15 @@
 // ============================================================================
 // Query: Top N Quarterly Cost by Resource Group
 // Description:
-//   Returns the top N resource groups by total effective cost over the last quarter (3 months).
-//   Includes monthly breakdown and subaccount context for each resource group.
+//   Returns the top N cost rows (by resource group, subaccount, and month) over the last quarter (3 months).
+//   Each row represents one resource group in one month — useful for identifying the highest single-month cost drivers.
 // Author: FinOps Toolkit
 // Parameters:
 //   N: Number of top resource groups to return (default: 5)
 //   startDate: Start date for the reporting period (e.g., startofmonth(ago(90d)))
 //   endDate: End date for the reporting period (e.g., startofmonth(now()))
 // Output:
-//   Each row represents a resource group, subaccount, and month with its total effective cost.
+//   Each row is a (resource group, subaccount, month) combination with its total effective cost.
 // Usage:
 //   Use this query to identify major cost drivers and trends at the resource group level for quarterly reporting.
 // Last Tested: 2025-05-17

src/queries/finops-hub-database-guide.md

@@ -91,8 +91,8 @@ The FinOps hubs database is designed to support advanced cost and usage analytic
 
 ## Query Best Practices
 
-- **Start with the CostsPlus Query:**  
-  Use the provided CostsPlus query as your base for any cost or usage analytics. This ensures you benefit from the latest schema, enrichment logic, and FinOps best practices.
+- **Start with the [`costs-enriched-base`](./catalog/costs-enriched-base.kql) query:**
+  Use this query as your base for any cost or usage analytics. It provides the full enrichment and savings logic for all cost columns and is the recommended foundation for custom analytics and reporting.
 
 - **Use KQL (Kusto Query Language):**  
   All queries should be written in KQL for compatibility with Azure Data Explorer.

src/templates/claude-plugin/.build.config

@@ -0,0 +1,3 @@
+{
+  "unversionedZip": true
+}

src/templates/claude-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "finops-toolkit",
+  "version": "1.0.0",
+  "description": "Claude plugin for FinOps Toolkit, providing tools and integrations for financial operations management.",
+  "author": {
+    "name": "FinOps Toolkit Team",
+    "url": "https://github.com/microsoft"
+  },
+  "homepage": "https://learn.microsoft.com/en-us/cloud-computing/finops/toolkit/finops-toolkit-overview",
+  "repository": "https://github.com/microsoft/finops-toolkit",
+  "license": "MIT",
+  "keywords": ["finops", "cost-management", "reservations", "savings plans", "cloud-optimization", "commitments", "credits", "MACC"],
+  "commands": "./commands/",
+  "agents": ["./agents/chief-financial-officer.md", "./agents/finops-practitioner.md", "./agents/ftk-database-query.md", "./agents/ftk-hubs-agent.md"],
+  "skills": "./skills/",
+  "mcpServers": {
+    "azure-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@azure/mcp@latest", "server", "start", "--namespace", "kusto", "--read-only"]
+    }
+  },
+  "outputStyles": "./output-styles/"
+}