CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vertex-engine-inspector

Inspect and validate Vertex AI Agent Engine deployments including Code Execution Sandbox, Memory Bank, A2A protocol compliance, and security posture. Generates production readiness scores. Use when asked to inspect, validate, or audit an Agent Engine deployment. Trigger with "inspect agent engine", "validate agent engine deployment", "check agent engine config", "audit agent engine security", "agent engine readiness check", "vertex engine health", or "reasoning engine status".

Quality

86%

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

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

A well-structured, specific, largely lean instruction skill with a clear 10-step workflow, embedded validation criteria, and a useful error-recovery table. The main gaps are missing executable code snippets (SDK connection, scoring weights), a few filler lines, and orphaned bundle files — especially the two scripts that are never referenced.

Suggestions

Reference the executable tooling in the Instructions section (e.g., 'Run scripts/check-security.py for the IAM/VPC-SC/encryption checks in step 6, or scripts/inspect-agent.sh for the full phased inspection') or remove the unreferenced scripts from the bundle.

Add a short copy-paste Python snippet for step 1 connection (vertexai.Client initialization plus client.agent_engines.get) and inline the category scoring weights used in step 9, which currently live in a reference file without being pointed to.

Trim the 'Familiarity with Vertex AI Agent Engine concepts' prerequisite and the three unlinked Resources entries, and link references/examples.md from the Examples section instead of duplicating its scenarios inline.

DimensionReasoningScore

Conciseness

The body is information-dense and assumes competence — no explanations of what Vertex AI or A2A are, and the 'no gcloud CLI surface' note is genuinely non-obvious. Minor trims remain: the 'Familiarity with Vertex AI Agent Engine concepts' prerequisite bullet is human-resume filler, and three of five Resources entries ('Model Armor -- prompt injection protection configuration') are unlinked low-value pointers. Not anchor 5 because those tokens do not earn their place; well above anchor 3 since there is no real padding.

4 / 5

Actionability

Guidance is concrete and specific: exact endpoints ('/.well-known/agent-card', 'POST /v1/tasks:send'), exact thresholds (TTL 7-14 days, 'SECURE_ISOLATED', min 100 memories, error rate < 5%), IAM role names, a runnable gcloud command, and SDK method names ('client.agent_engines.get(name=...)'). Minor gaps keep it below anchor 5: no copy-paste SDK connection snippet, no inline scoring weights (step 9 says 'calculate weighted scores' without the weights), and curl probes are described but not exemplified.

4 / 5

Workflow Clarity

Ten numbered steps in a coherent connect-then-validate-then-score sequence, each with embedded pass/fail criteria ('confirm state TTL is 7-14 days', 'error rate (target < 5%)'), plus an Error Handling table mapping failures to causes and solutions — a solid recovery loop. Below anchor 5 because checkpoints are implicit in step prose rather than explicit validate/branch points, and the flow on partial failure (does a failed category abort or continue?) is unspecified. This is a read-only skill, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The ~70-line body is a well-sectioned overview with clearly signaled one-level-deep references ('See [references/inspection-workflow.md](...) for the phased inspection process'), all of which exist. However, scoring against the actual bundle: references/ARD.md, references/PRD.md, references/examples.md and both executable scripts (scripts/check-security.py, scripts/inspect-agent.sh) are never mentioned in the body, leaving real tooling undiscoverable — an organization gap that prevents anchor 5.

4 / 5

Total

16

/

20

Passed

Description

95%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: third-person voice, concrete actions, explicit 'Use when' guidance, and comprehensive trigger phrases including product-name synonyms. The only minor weakness is that 'inspect' and 'validate' are near-synonymous and the capability list omits the performance/monitoring categories the body actually covers.

DimensionReasoningScore

Specificity

The description names several concrete actions ('Inspect and validate Vertex AI Agent Engine deployments', 'Generates production readiness scores') and enumerates four coverage areas (Code Execution Sandbox, Memory Bank, A2A protocol compliance, security posture). It falls just short of anchor 5 because 'inspect' and 'validate' overlap heavily and coverage omits performance metrics and monitoring categories that the skill actually handles.

4 / 5

Completeness

It explicitly answers both questions: 'what' ('Inspect and validate Vertex AI Agent Engine deployments including... Generates production readiness scores') and 'when' ('Use when asked to inspect, validate, or audit an Agent Engine deployment. Trigger with...') with concrete trigger phrases, exactly matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Seven natural trigger phrases are provided ('inspect agent engine', 'validate agent engine deployment', 'check agent engine config', 'audit agent engine security', 'agent engine readiness check', 'vertex engine health', 'reasoning engine status') covering the verbs users would actually say plus product-name synonyms (agent engine / reasoning engine / vertex engine). This matches the comprehensive-synonyms anchor; no meaningful natural variation is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (Vertex AI Agent Engine deployment inspection) with distinct product-specific triggers ('agent engine readiness check', 'reasoning engine status'). Unlikely to fire for generic security-audit or cloud-health skills; minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/ai-ml/jeremy-vertex-engine/skills/vertex-engine-inspector/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.