Skip to content

[skills] Add EKS Operation Review skill#3

Open
kahhaw9368 wants to merge 1 commit into
aws-samples:mainfrom
kahhaw9368:feat/eks-operation-review-skill
Open

[skills] Add EKS Operation Review skill#3
kahhaw9368 wants to merge 1 commit into
aws-samples:mainfrom
kahhaw9368:feat/eks-operation-review-skill

Conversation

@kahhaw9368

Copy link
Copy Markdown

Summary

Adds the EKS Operation Review skill as a sixth portable skill under skills/, following the existing CloudOps skill conventions (3-path routing, Use when… trigger, CloudOps frontmatter). It runs a structured 10-section EKS operational excellence assessment against a live cluster (read-only) and produces a GREEN/AMBER/RED rated report with prioritized recommendations. Checks are informed by the EKS Best Practices Guide and EKS User Guide.

What's included

  • skills/eks-operation-review/SKILL.md — CloudOps-style frontmatter (user-invocable, argument-hint, allowed-tools), a 3-path routing block (EKS MCP tools → AWS CLI + kubectl → delegate), and a read-only Constraints section.
  • steering/ — 11 per-section assessment files (cluster lifecycle, IaC/GitOps, access & identity, observability, workload config, networking, autoscaling, deployment practices, operational processes, add-on management) + report-generation.
  • tools/report_to_html.py — Markdown → HTML report converter (no external deps).
  • reference/workflow.md — full assessment workflow (pre-flight, sections 1–10, rubric, report format), paths adapted to the CloudOps layout.
  • reference/mcp-setup.md + reference/mcp.json.example — setup for the two pinned MCP servers (awslabs.eks-mcp-server@0.1.28, awslabs.aws-documentation-mcp-server@1.1.21).
  • README.md — skills table row + project-structure entry.

Testing

Verified end-to-end against a live cluster (Section 06 — Networking): steering loads from the new path, MCP checks execute (VPC config, aws-node DaemonSet, CoreDNS, NetworkPolicy, vpc-cni addon), the rated report writes to reports/ with the correct filename format, and report_to_html.py produces valid HTML. Smoke-test artifacts were not committed.

Scope

Skill-only change — no agent hierarchy, Lambda tool, or Terraform changes (src/agents/hierarchy.json, src/lambda, and terraform/ are untouched).


Source skill: https://github.com/aws-samples/sample-eks-operation-review-skill (MIT-0).

Integrate the EKS Operation Review skill as a sixth portable skill under
skills/, mirroring the existing CloudOps skill conventions. The skill runs
a structured 10-section operational excellence assessment against a live
EKS cluster and produces a GREEN/AMBER/RED rated report with prioritized
recommendations. All operations are read-only.

What's included:
- SKILL.md with CloudOps-style frontmatter (user-invocable, argument-hint,
  allowed-tools), a 3-path routing block (EKS MCP tools -> AWS CLI+kubectl
  -> delegate), and a Constraints section (read-only, no fabrication,
  reports written inside the workspace only).
- 11 steering files (one per assessment section + report-generation) and
  the report_to_html.py converter, copied from the source skill.
- reference/workflow.md (ported from the source .claude/commands entry
  point, paths adapted to the CloudOps layout) and reference/mcp-setup.md
  + reference/mcp.json.example for the two pinned MCP servers
  (awslabs.eks-mcp-server@0.1.28, awslabs.aws-documentation-mcp-server@1.1.21).
- README.md skills table + project-structure entries.

Skill-only change: no agent hierarchy, Lambda tool, or Terraform changes.

Verified end-to-end against a live cluster (Section 06 Networking): steering
loads from the new path, MCP checks execute, the rated report writes to
reports/, and HTML conversion succeeds.
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.

1 participant