agents-at-scale-ark: Skill for Claude Code

.claude/skills/architecture/SKILL.md

ark-architecture is a skill for Claude Code from mckinsey/agents-at-scale-ark. It costs 29 tokens per session (323 once invoked), scanned A, original, Apache-2.0.

An architecture-planning guide for designing new Ark features around the platform's existing components, data models, and development patterns.

In plain words
What is it for?
It is for evaluating technical approaches, planning component and data-model changes, and breaking feature work into smaller deliverable steps.
Why use it?
It helps teams make incremental changes while avoiding designs that are difficult to reuse or reverse later.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is mckinsey/agents-at-scale-ark's own configuration. It tells Claude Code how to work on agents-at-scale-ark itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agents-at-scale-ark configures →

Reuse

Borrowing it

Nothing to install: this file belongs to mckinsey/agents-at-scale-ark. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/mckinsey/agents-at-scale-ark/main/.claude/skills/architecture/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/mckinsey/agents-at-scale-ark

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ark-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/mckinsey/agents-at-scale-ark/architecture/github.svg)](https://agentmods.dev/skills/mckinsey/agents-at-scale-ark/architecture)
Your own site
<a href="https://agentmods.dev/skills/mckinsey/agents-at-scale-ark/architecture"><img src="https://agentmods.dev/badge/skills/mckinsey/agents-at-scale-ark/architecture/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ark-architecture

Your own site · 80×15
<a href="https://agentmods.dev/skills/mckinsey/agents-at-scale-ark/architecture"><img src="https://agentmods.dev/badge/skills/mckinsey/agents-at-scale-ark/architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 323 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.00323
Opus 5 $0.00015 $0.00161
Sonnet 5 $0.00006 $0.00065
Haiku 4.5 $0.00003 $0.00032

Measured 7d ago against content hash f75e749d6eb5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

ark-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/architecture/SKILL.md · 38 lines

What it actually says

Ark Architecture Skill

Design architecture for Ark features following existing patterns and principles.

Process

  1. Analyze Current Solution - Use the ark-analysis skill to examine relevant parts of the codebase
  2. Identify Patterns - Find existing idioms, data models, and service structures to reuse
  3. Design for Reuse - Extend existing components rather than creating new ones
  4. Enable Incremental Updates - Break changes into small, independent pieces
  5. Flag One-Way Decisions - Raise questions on choices that are hard to reverse

Principles

  • Reuse over creation - Extend existing services, models, and patterns
  • Follow existing idioms - Match current code style, naming, and structure
  • Incremental delivery - Design so features can be shipped in stages
  • Reversibility - Identify and question decisions that lock in future options

Conventions

  • Watch endpoints: Use ?watch=true query param for SSE streaming (Kubernetes-style)
  • Service ports: Use named ports (e.g., port: mcp) rather than port numbers

Output

Architecture documents should include:

  • Component diagram showing how new pieces fit with existing ones
  • Data model extending current schemas
  • API design following existing conventions
  • List of one-way decisions requiring team input
  • Implementation phases for incremental delivery
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 38 lines · 29 tokens per session scan A f75e749d6eb5

Subscribe to this mod's changes

ark-architecture is a skill published in the GitHub repository mckinsey/agents-at-scale-ark (422 stars, last pushed yesterday), licensed Apache-2.0. It adds 29 tokens to every session and 323 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

container-manager-kubernetes-operations

Full operational Kubernetes surface via the container-manager-mcp MCP server — workloads (pods/rollouts/StatefulSets/DaemonSets/ReplicaSets/Jobs/CronJobs), config (ConfigMaps/Secrets/Namespaces/CRDs/patch), networking (Ingress/native Services/NetworkPolicy/DNS), storage (PV/PVC/StorageClass/snapshots/CSI), RBAC…

Knuckles-Team/container-manager-mcp · 189 tokens

k8s-ops

Opinionated multi-step Kubernetes workflows on top of the k8s-mcp server. Encodes tool-sequencing logic and failure-mode decision trees for deploying from a repo, debugging pods/rollouts, performing safe restarts, and auditing cluster posture. Use when the user asks to deploy, diagnose, restart, roll out, or audit…

jingyanjiang/k8s-mcp · 77 tokens

kubernetes-mesh-provisioner

Kubernetes Mesh Provisioner atomic skill. Stands up an RKE2 cluster (server + agents) with Cilium CNI and the NVIDIA GPU device plugin, the Kubernetes parallel of swarm-mesh-provisioner. Idempotent — re-runnable.

Knuckles-Team/container-manager-mcp · 60 tokens

cost-optimization

Optimize cloud costs across AWS, Azure, GCP, and OCI through resource rightsizing, tagging strategies, reserved instances, and spending analysis. Use when reducing cloud expenses, analyzing infrastructure costs, or implementing cost governance policies.

wshobson/agents · 48 tokens

network-rca

Kubernetes network root cause analysis skill powered by Kubeshark MCP. Use this skill whenever the user wants to investigate past incidents, perform retrospective traffic analysis, take or manage traffic snapshots, extract PCAPs, dissect L7 API calls from historical captures, compare traffic patterns over time, detect…

kubeshark/kubeshark · 163 tokens

linkerd-patterns

Implement Linkerd service mesh patterns for lightweight, security-focused service mesh deployments. Use when setting up Linkerd, configuring traffic policies, or implementing zero-trust networking with minimal overhead.

wshobson/agents · 41 tokens