Skip to content

feat(plugins): add FinOps Toolkit agent plugins#2167

Open
MSBrett wants to merge 4 commits into
devfrom
features/sre-agent-plugins
Open

feat(plugins): add FinOps Toolkit agent plugins#2167
MSBrett wants to merge 4 commits into
devfrom
features/sre-agent-plugins

Conversation

@MSBrett

@MSBrett MSBrett commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Replaces part of #2111.

Scope:

  • Adds Copilot plugin, Claude plugin, shared agent skills, and plugin marketplace metadata.
  • Includes the Update-Version.ps1 plugin-version wiring related to those template assets.

Review notes:

  • Base: dev.
  • Split plan: memory://projects/finops-toolkit/pr-2111-split-plan.

Verification:

@microsoft-github-policy-service microsoft-github-policy-service Bot added the Needs: Review 👀 PR that is ready to be reviewed label Jun 3, 2026
@MSBrett MSBrett marked this pull request as ready for review June 3, 2026 15:54
@MSBrett MSBrett requested a review from flanakin as a code owner June 3, 2026 15:54
Copilot AI review requested due to automatic review settings June 3, 2026 15:54

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds FinOps Toolkit “agent plugin” assets (Copilot CLI + Claude), expands shared FinOps/Cost Management agent skills, and wires plugin/marketplace version updates into the repo versioning script.

Changes:

  • Introduces a new Copilot CLI plugin template (commands, agents, skills, marketplace metadata).
  • Updates Claude plugin agents/output-style and extends the shared skill/query catalog guidance.
  • Extends Update-Version.ps1 to update Copilot plugin and marketplace manifests.

Reviewed changes

Copilot reviewed 35 out of 35 changed files in this pull request and generated 14 comments.

Show a summary per file
File Description
src/templates/copilot-plugin/README.md New Copilot CLI plugin README covering install and included assets.
src/templates/copilot-plugin/plugin.json New Copilot CLI plugin manifest (commands/agents/skills + MCP server).
src/templates/copilot-plugin/commands/ftk/ytd-report.md New Copilot command prompt for fiscal YTD reporting.
src/templates/copilot-plugin/commands/ftk/mom-report.md New Copilot command prompt for month-over-month reporting.
src/templates/copilot-plugin/commands/ftk/hubs-healthCheck.md New Copilot command prompt for hub version + freshness checks.
src/templates/copilot-plugin/commands/ftk/hubs-connect.md New Copilot command prompt for hub discovery/connection + env persistence.
src/templates/copilot-plugin/commands/ftk/cost-optimization.md New Copilot command prompt for Advisor/orphaned/rightsizing optimization report.
src/templates/copilot-plugin/agents/ftk-hubs-agent.agent.md New Copilot agent definition for hub deployment/ops.
src/templates/copilot-plugin/agents/ftk-database-query.agent.md New Copilot agent definition for FinOps hubs KQL evidence ownership.
src/templates/copilot-plugin/agents/finops-practitioner.agent.md New Copilot agent definition for practitioner orchestration role.
src/templates/copilot-plugin/agents/chief-financial-officer.agent.md New Copilot agent definition for CFO framing role.
src/templates/copilot-plugin/.build.config Build packaging config for the Copilot plugin template.
src/templates/claude-plugin/README.md Updates Claude plugin README to reflect new agent topology and catalog notes.
src/templates/claude-plugin/output-styles/ftk-output-style.md Extends output style guidance (capacity mapping, data sufficiency language, terminology).
src/templates/claude-plugin/agents/ftk-database-query.md Updates Claude agent guidance (Kusto boundary/ownership, query strategy).
src/templates/claude-plugin/agents/finops-practitioner.md Updates orchestration model and FinOps capability wording.
src/templates/claude-plugin/agents/chief-financial-officer.md Updates CFO agent boundaries and collaboration expectations.
src/templates/claude-plugin/agents/azure-capacity-manager.md Adds new Claude subagent for Azure capacity evidence.
src/templates/claude-plugin/.claude-plugin/plugin.json Updates Claude plugin manifest (agents list + version).
src/templates/agent-skills/finops-toolkit/SKILL.md Expands query catalog list and updates guidance wording/links.
src/templates/agent-skills/finops-toolkit/references/top-cost-drivers.md Adjusts recommended workflow to prefer aggregate queries before row-level bases.
src/templates/agent-skills/finops-toolkit/references/finops-hubs.md Updates catalog guidance and reference links (FinOps Foundation).
src/templates/agent-skills/finops-toolkit/references/custom-dimension-analysis.md Updates workflow guidance to prefer scenario-specific catalog queries first.
src/templates/agent-skills/finops-toolkit/references/cost-comparison.md Updates comparison workflow guidance to prefer aggregate queries first.
src/templates/agent-skills/finops-toolkit/README.md Updates catalog count and query descriptions.
src/templates/agent-skills/azure-cost-management/references/azure-vm-rightsizing.md Updates FinOps Framework capability link (usage optimization).
src/templates/agent-skills/azure-cost-management/references/azure-savings-plans.md Updates FinOps Framework capability link (rate optimization).
src/templates/agent-skills/azure-cost-management/references/azure-retail-prices.md Updates FinOps Framework capability link (rate optimization).
src/templates/agent-skills/azure-cost-management/references/azure-orphaned-resources.md Updates FinOps Framework capability link (usage optimization).
src/templates/agent-skills/azure-cost-management/references/azure-commitment-discount-decision.md Updates FinOps Framework capability link (rate optimization).
src/scripts/Update-Version.ps1 Updates prerelease label behavior and expands version propagation to Copilot + marketplace.
.github/plugin/marketplace.json Adds Copilot CLI marketplace manifest for plugin distribution.

Comment thread src/templates/copilot-plugin/plugin.json Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/cost-optimization.md Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/cost-optimization.md Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/cost-optimization.md Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/cost-optimization.md Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/hubs-connect.md Outdated
Comment thread src/templates/copilot-plugin/agents/ftk-database-query.agent.md Outdated
Comment thread src/templates/copilot-plugin/commands/ftk/mom-report.md Outdated
Comment thread src/scripts/Update-Version.ps1
Comment thread src/templates/copilot-plugin/agents/ftk-database-query.agent.md Outdated
msbrett and others added 2 commits June 3, 2026 09:32
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@MSBrett MSBrett enabled auto-merge (squash) June 4, 2026 13:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Review 👀 PR that is ready to be reviewed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants