Skip to content

Create blog post for agent skills for AKS#5683

Open
julia-yin wants to merge 1 commit intomasterfrom
julia/aks-skill-blog
Open

Create blog post for agent skills for AKS#5683
julia-yin wants to merge 1 commit intomasterfrom
julia/aks-skill-blog

Conversation

@julia-yin
Copy link
Copy Markdown
Contributor

Creating a new blog post announcing agent skills for AKS, now available through the GitHub Copilot for Azure extension in VS Code, Visual Studio, Copilot CLI, and Claude. The first set of skills cover best practices for AKS and AKS troubleshooting.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new Docusaurus blog post announcing “Agent Skills for AKS” and introduces a new curated skills blog tag to categorize related content.

Changes:

  • Added a new skills tag entry in website/blog/tags.yml.
  • Created a new draft blog post at website/blog/2026-03-26-agent-skills-for-aks/index.md describing the feature and how to install/use it.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
website/blog/tags.yml Adds the skills tag metadata (label/permalink/description) for consistent tagging and permalinks.
website/blog/2026-03-26-agent-skills-for-aks/index.md New draft blog post content introducing Agent Skills for AKS, with installation steps and example usage.

description: "Announcing agent skills for AKS, easily pluggable into any agent to enhance them with built-in AKS expertise, safer workflows, and reduced developer overhead."
authors: [julia-yin]
tags: [agent, skills, mcp, developer]
draft: true
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

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

draft: true keeps the post out of production builds. The PR description reads like a publication/announcement; either set draft: false before merging or clarify that this PR is intentionally landing as a draft-only post.

Copilot uses AI. Check for mistakes.
For AKS, skills matter because AI agents already carry a good baseline of Kubernetes and AKS knowledge, but that knowledge is only as current as their training data and varies across models. What agents typically lack is the prescriptive, up-to-date guidance specific to AKS: what the AKS engineering team recommends today, the exact workflows and tools for real troubleshooting scenarios, and the guardrails that keep changes safe in production. Today, we're releasing the first set of skills covering the two areas teams ask for help with most: best practices for AKS clusters and scenario-based troubleshooting.

<!-- truncate -->

Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

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

Per the blog post content guidelines, a hero image (typically ./hero-image.png) should be placed immediately after <!-- truncate -->. This post currently has no hero image and the folder contains only index.md, so it won’t meet the expected post structure.

Suggested change
![Agent skills for AKS hero diagram](./hero-image.png)

Copilot uses AI. Check for mistakes.
Comment on lines +27 to +28
1. A high level **AKS best practices** skill:
1. Sub-skills for **AKS troubleshooting**:
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

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

These numbered list entries are incomplete (they end with : but don’t list the actual skill names/links/details). Also, “high level” should be hyphenated as “high-level” when used as an adjective.

Suggested change
1. A high level **AKS best practices** skill:
1. Sub-skills for **AKS troubleshooting**:
1. A high-level **AKS best practices** skill that covers cluster design, configuration, and operations.
2. Sub-skills for **AKS troubleshooting** focused on common node health and networking issues.

Copilot uses AI. Check for mistakes.
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.

I think you could take out line 27&28, since 30-36 covers the skills in details


The GitHub Copilot for Azure plugin is available through VS Code, Claude, and Copilot CLI and bundles AKS skills alongside 20+ skills across cost optimization, other Azure resources, and deployment workflows. Learn more about [GitHub Copilot for Azure](https://learn.microsoft.com/azure/developer/github-copilot-azure/introduction?tabs=vscode), and get the extension:

**Install the Azure plugin to VS Code:**
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.

Could you add some screenshots here?

1. Go to [skills.sh](https://skills.sh/microsoft/github-copilot-for-azure) and locate the AKS skills: [azure-kubernetes](https://skills.sh/microsoft/github-copilot-for-azure/azure-kubernetes) and [azure-diagnostics](https://skills.sh/microsoft/github-copilot-for-azure/azure-diagnostics).
1. Follow the `npx skills add` command at the top of the page to install the skill directly.
1. Run any AKS-related prompt — for example, *"Review my cluster for best practices"* — and the skill will activate automatically.

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.

consider adding a section about how these aks skills differ or complement other aks ai capabilities? Like the AKS MCP server and agentic cli


## Conclusion

AKS skills give your agents a baseline of production AKS knowledge using the same guidance, commands, and diagnostic approaches that AKS engineers use. The first release covers best practices and troubleshooting, and we are planning to cover more scenarios based on customer feedback. If you run into issues or have scenarios you'd like to see covered, please feel free to open an issue on the [AKS repository](https://github.com/Azure/AKS/issues).
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.

Do you want to open up an issue specifically for aks skills and link that here and people can make requests on that issue directly so it's easier to track / upvote other people's requests?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants