CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-platform-inference

Connects to and performs inference with Google Cloud Agent Platform GenAI models, including First-Party Gemini models and Third-Party OpenMaaS models (Llama, DeepSeek, Qwen, etc.). Use when asked to perform inference, ask a model a question, run a test prompt, execute chat completions, or generate code for calling Gemini or OpenMaaS models, authenticate with GenAI SDK, OpenAI SDK, or legacy Agent Platform SDK, configure base URLs and global/regional endpoints, or troubleshoot 429 Resource Exhausted (DSQ), 400 User Validation, or 404 Not Found errors. Don't use for deploying models to endpoints or for running model evaluations.

Quality

87%

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

71%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.

Highly actionable, workflow-safe content with genuine validation loops and verified script delegation, weakened by verbosity (a duplicated tip and a warning repeated three times) and an oversized monolithic body that inlines material a references/ directory should hold. Navigation defects (wrong section numbers, a missing section 3, and dead bracket links) further reduce workflow clarity.

Suggestions

Remove the duplicated "Alternative: Environment Variables" tip in §2 and consolidate the thinking-token/maxOutputTokens warning — currently repeated in §4a, §4b, and the Troubleshooting section — into one canonical location with brief cross-references.

Move the custom-endpoint REST recipes (§4a–4d) and the OpenMaaS model availability table into reference files (e.g., references/custom-endpoints.md, references/model-availability.md), keeping SKILL.md an overview with clearly signaled one-level links, as is already done well for the scripts/ files.

Fix the navigation defects: the overview's section numbers (Gemini—section 2, OpenMaaS—section 3) don't match the actual headings (## 1, ## 2, ## 4 with no section 3), the decision tree's "[1. Gemini Models]" / "[2. OpenMaaS Models]" links are not real markdown links, and the "Model IDs & Availability" IMPORTANT note is a collapsed run-on paragraph that should be reformatted as a list.

DimensionReasoningScore

Conciseness

Most of the body is non-obvious platform detail (endpoint URLs, model IDs, gcloud commands), but there is real waste: the "Alternative: Environment Variables" tip is duplicated verbatim twice in a row, the thinking-token/maxOutputTokens warning appears three times (§4a, §4b, and the Empty-response troubleshooting subsection), and the "Model IDs & Availability" note is a collapsed run-on paragraph repeating documentation links given elsewhere. Matches "mostly efficient but includes some unnecessary explanation or could be tightened"; not 4 because the duplication goes beyond minor instances.

3 / 5

Actionability

Fully executable throughout: a complete curl availability probe with auth header, gcloud setup commands, pip installs with a probe-first fallback, copy-paste REST recipes with real payloads for all three custom-endpoint types (generateContent, chat/completions, predict), inline Python SDK examples, and six verified working scripts in scripts/ plus verify_all.sh. Covers the common Gemini, OpenMaaS, and custom-endpoint cases; matches anchor 5.

5 / 5

Workflow Clarity

The Workflow Decision Tree, numbered Phase 0 setup, parameter-grounding ask-halt rules, and the region-availability probe with explicit 200/404/other interpretation branches provide clear sequencing with real validation and error-recovery loops (plus the Tier R confirmation and troubleshooting cause→action tables). Held at 4 rather than 5 because navigation is defective: the overview cites sections 2/3/4 while the actual headings are 1/2/4 with no section 3, and decision-tree links like "[1. Gemini Models]" are plain bracket text, not real markdown links.

4 / 5

Progressive Disclosure

Code examples are well delegated to six real, clearly signaled scripts/ files (all verified to exist with substantive content), and attribution.md is a clearly signaled one-level reference. However, nearly everything else is inlined in an ~835-line SKILL.md: the custom-endpoint recipes (§4a–4d), the OpenMaaS model availability table, and the troubleshooting catalog would fit the references/ pattern, of which only attribution.md exists. Sits between anchors 3 and 4; scored 3 because the majority of detailed, reference-worthy content remains inline rather than split out.

3 / 5

Total

15

/

20

Passed

Description

100%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.

A strong description: concrete third-person capabilities, an explicit 'Use when' clause with natural trigger phrases, synonyms, named model families and SDKs, and explicit scope exclusions. All four dimensions clearly match the top anchors with no vague or padded language.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "performs inference", "execute chat completions", "generate code for calling Gemini or OpenMaaS models", "authenticate with GenAI SDK, OpenAI SDK, or legacy Agent Platform SDK", "configure base URLs and global/regional endpoints", "troubleshoot 429 Resource Exhausted (DSQ), 400 User Validation, or 404 Not Found errors" — comprehensively covering the skill's functions in third person. Not 4: coverage spans inference, auth, endpoint configuration, and error-specific troubleshooting with no material gaps.

5 / 5

Completeness

Explicitly answers both what ("Connects to and performs inference with Google Cloud Agent Platform GenAI models, including First-Party Gemini models and Third-Party OpenMaaS models") and when ("Use when asked to perform inference, ask a model a question, run a test prompt...") with concrete trigger phrases, and adds explicit exclusions ("Don't use for deploying models to endpoints or for running model evaluations"). Clearly the anchor-5 case, not 4 where the 'when' is merely present.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered: "perform inference", "ask a model a question", "run a test prompt", "execute chat completions", plus model family names (Llama, DeepSeek, Qwen) and specific error codes for troubleshooting intents. Matches the anchor-5 comprehensive example including synonyms; only trivial variants like "chat with a model" are absent.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Google Cloud Agent Platform GenAI inference) with distinct model-family and SDK triggers, and negative triggers ("Don't use for deploying models to endpoints or for running model evaluations") that cleanly separate it from the companion deployment/eval skills. Minimal conflict risk; not 4 because no meaningful overlap remains.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (851 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

google/skills

Path

skills/cloud/agent-platform-inference/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.