CtrlK
BlogDocsLog inGet started
Tessl Logo

validator-expert

Validate production readiness of Vertex AI Agent Engine deployments across security, monitoring, performance, compliance, and best practices. Generates weighted scores (0-100%) with actionable remediation plans. Use when asked to validate a deployment, run a production readiness check, audit security posture, or verify compliance for Vertex AI agents. Trigger with "validate deployment", "production readiness", "security audit", "compliance check", "is this agent ready for prod", "check my ADK agent", "review before deploy", or "production readiness check". Make sure to use this skill whenever validating ADK agents for Agent Engine.

78

Quality

75%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/ai-ml/jeremy-vertex-validator/skills/validator-expert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that clearly defines its scope (Vertex AI Agent Engine production readiness validation), lists concrete outputs (weighted scores, remediation plans), and provides comprehensive trigger guidance with both formal and colloquial phrases. It uses proper third-person voice throughout and is highly distinctive in its domain focus.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: validate production readiness, assess security/monitoring/performance/compliance/best practices, generate weighted scores (0-100%), and produce actionable remediation plans. These are concrete, measurable outputs.

3 / 3

Completeness

Clearly answers both 'what' (validate production readiness across multiple dimensions, generate weighted scores with remediation plans) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios, plus a 'Trigger with...' list of specific phrases).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including both formal ('validate deployment', 'production readiness', 'security audit', 'compliance check') and informal ('is this agent ready for prod', 'check my ADK agent', 'review before deploy'). Also includes domain-specific terms like 'Vertex AI', 'ADK agents', 'Agent Engine'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Vertex AI Agent Engine production readiness validation. The combination of platform-specific terms (Vertex AI, ADK, Agent Engine) and task-specific terms (production readiness, deployment validation) makes it very unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This skill provides a well-structured framework for Vertex AI Agent Engine production readiness validation with clear categories, scoring weights, and error handling. Its main weaknesses are the lack of executable code for performing the actual validation checks (most steps are descriptive rather than actionable) and redundancy between inline instructions and referenced checklist files. The workflow would benefit from concrete gcloud/API commands for each check and explicit pass/fail gates between validation phases.

Suggestions

Replace descriptive check items ('verify X exists', 'confirm Y is enabled') with specific executable gcloud or API commands that actually perform each validation, e.g., `gcloud projects get-iam-policy $PROJECT --format=json | jq '.bindings[] | select(.role=="roles/aiplatform.admin")'`

Add explicit validation gates between phases—e.g., 'If deployment retrieval (step 1) fails or returns incomplete config, STOP and resolve before running validation suites'

Remove inline duplication of checklist content from the Instructions section since the referenced checklist files should contain those details; keep only summary-level descriptions in the main body

Provide at least one complete executable example showing the full validation flow with sample output format, rather than just scenario descriptions

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary verbosity—the Prerequisites section explains things Claude can infer, the Overview restates what the instructions already cover, and the Examples section describes scenarios without providing concrete executable examples. The error handling table is useful but could be tighter.

2 / 3

Actionability

The skill provides specific API endpoints, gcloud commands, and SDK calls which is good, but the core validation steps are descriptive checklists ('check if X is enabled', 'verify Y exists') rather than executable code or concrete commands to actually perform each check. There's no copy-paste-ready validation script or specific gcloud/API commands for most individual checks.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and logically ordered from retrieval through scoring to recommendations. However, there are no explicit validation checkpoints or feedback loops—no 'if check fails, do X before proceeding' gates between major phases. For a validation workflow that could produce misleading results with partial data, this is a gap.

2 / 3

Progressive Disclosure

The skill references three checklist files in a references/ directory and links to external Google Cloud docs, which is good structure. However, no bundle files were provided, so the referenced files don't actually exist, and the main body still contains substantial inline detail that overlaps with what the checklists presumably cover (e.g., the security checks in step 2 duplicate what security-checklist.md should contain).

2 / 3

Total

8

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.