CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-platform-architecture

Designs, engineers, and validates enterprise Gemini platform architectures. Use when designing multi-project hierarchies (Host, Central Governance Hub, Runtime Spoke, Tool/MCP Spoke), configuring Agent Gateway, authoring Agent Connectivity Templates (ALL_TRAFFIC vs PRIVATE_RANGES_ONLY), deploying Secure Web Proxy (SWP) with Policy-Based Routing (PBR) or Cross-Cloud mTLS Egress Hubs, configuring Private CA TrustConfig with Internal ALB + Serverless NEG, implementing Unified Access Policies (UAP Policy V2 CEL) and Semantic Governance (SGP), configuring 3P IdP Token Exchange (EntraID/Ping/Okta via ext_proc + STS) or Agent Identity Auth Manager (SPIFFE), enforcing Model Armor Floor Settings and Fail-Closed guardrails, deploying Cross-Project Registry sync, binding ADK agents on Agent Runtime, or executing Day-2 lifecycle operations. Don't use for read-only live log triage or incident diagnosis, or generic Google Cloud Identity and Access Management (IAM) debugging.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured overview that routes to seven verified, one-level-deep reference manuals, backed by concrete bootstrap commands, a decision tree, and a sequenced 3-phase workflow gated by a human-approval checkpoint. It could be tightened (redundant 'single source of truth' statements, long intro paragraph) and its error-recovery feedback loops are left implicit in references rather than stated in the workflow.

Suggestions

State the 'single source of truth' rule once (either the IMPORTANT callout or the Domain Router intro) and compress the opening paragraph to a single sentence to reclaim tokens.

Inline one minimal example of the highest-frequency artifact (e.g., a ~10-line ACT YAML snippet or a single UAP Policy V2 CEL rule) so the most common cases are actionable without opening a reference manual.

Make Phase 3's verification loop explicit in the body — validate, fix, re-run the audit-log query — including the exact gcloud logging read command, rather than only linking to the checklist in references/topologies_and_project_layouts.md.

DimensionReasoningScore

Conciseness

Almost every section carries product-specific information Claude would not know (the exact services-enable command, IAM role names, precise error strings like 'Egress request is not authorized' and '[SSL: UNEXPECTED_EOF_WHILE_READING]'), with no space spent explaining concepts Claude already knows. Not 5: the 'single source of truth' rule is stated twice (IMPORTANT callout and Domain Router intro) and the opening paragraph plus the very wide table rows could be trimmed; not 3: the padding is minor, not 'several unnecessary explanations'.

4 / 5

Actionability

Contains concrete, copy-paste-ready commands ('gcloud services enable aiplatform.googleapis.com ...', 'gcloud billing projects describe {project_id} --format=...', auth setup) and exact decision parameters (vpcEgress = ALL_TRAFFIC vs PRIVATE_RANGES_ONLY, NEXT_HOP_ROUTING_MODE, 240.0.0.2:443). Not 5: the core authoring tasks (ACT YAML schemas, UAP CEL rules, TrustConfig) are only pointed at via references rather than shown inline, leaving minor gaps for the most common cases; not 3: what is present is executable and specific, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

A clearly sequenced 3-phase workflow (scope verification → draft architecture plan → post-deployment/audit-log verification) with a mermaid decision tree for the key egress choice and an explicit human-approval checkpoint for sensitive IAM/policy/delete operations; Phase 3 pairs with a verification checklist and runtime query validation. Not 5: explicit validate → fix → retry feedback loops are not spelled out in the body; not 3: validation checkpoints are present and explicit (approval gate, Phase 3 audit verification), not absent or merely implied.

4 / 5

Progressive Disclosure

The body is a pure router/overview: a 7-row Domain Router and Symptom Matrix mapping topics and failure symptoms to canonical one-level-deep reference manuals, all 8 referenced files (references/attribution.md plus the 7 domain manuals) verified to exist on disk, plus a MUST READ attribution pointer and public doc links. Not 4: navigation is well-signaled, references are exactly one level deep, and no reference content is unnecessarily inlined.

5 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a strong, third-person, trigger-rich statement: it enumerates a comprehensive set of concrete capabilities, provides an explicit 'Use when' clause with concrete triggers, and adds negative boundaries that reduce conflict risk. Its only weakness is jargon-heavy phrasing that misses a few natural user variations.

DimensionReasoningScore

Specificity

Lists roughly a dozen concrete verb-object actions ('configuring Agent Gateway', 'deploying Secure Web Proxy (SWP) with Policy-Based Routing (PBR)', 'enforcing Model Armor Floor Settings and Fail-Closed guardrails', 'binding ADK agents on Agent Runtime') with comprehensive coverage across design, networking, identity, governance, and operations. Not 4: the coverage leaves no significant gaps — it spans the full capability surface, not just several actions.

5 / 5

Completeness

Explicitly answers 'what' ('Designs, engineers, and validates enterprise Gemini platform architectures' plus enumerated actions) and 'when' ('Use when designing multi-project hierarchies ... or executing Day-2 lifecycle operations') with concrete trigger phrases, and adds negative triggers ('Don't use for read-only live log triage ... or generic ... IAM debugging'). Not 4: the 'when' clause is explicit, enumerated, and specific rather than merely present.

5 / 5

Trigger Term Quality

Dense with exact product names users of this niche would naturally say (Agent Gateway, Secure Web Proxy, Model Armor, SPIFFE, ADK, EntraID/Ping/Okta), including vendor synonyms. Not 5: a few natural phrasings such as 'VPC Service Controls' or 'private egress' are absent and the sheer jargon density may not match how less expert users phrase requests; not 3: keyword coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (enterprise Gemini platform architecture) with distinct product-specific triggers, and the explicit 'Don't use for' clause actively disambiguates from adjacent Google Cloud IAM/networking skills. Not 4: the negative boundary plus product-unique terms leave only minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

google/skills

Path

skills/cloud/agent-platform-architecture/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.