CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vertex-infra-expert

Execute use when provisioning Vertex AI infrastructure with Terraform. Trigger with phrases like "vertex ai terraform", "deploy gemini terraform", "model garden infrastructure", "vertex ai endpoints terraform", or "vector search terraform". Provisions Model Garden models, Gemini endpoints, vector search indices, ML pipelines, and production AI services with encryption and auto-scaling.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/devops/jeremy-vertex-terraform/skills/vertex-infra-expert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 skill body is a genuinely lean overview that delegates detail to a real one-level-deep reference bundle, but it functions as a table of contents rather than an actionable guide: no commands, code, or concrete steps appear in SKILL.md itself, validation is a single vague bullet, and several bundle files (implementation.md, init-terraform.sh) are unreachable or broken from the body. Tightening the pointers and surfacing at least a minimal executable baseline per step would lift the weakest dimensions.

Suggestions

Add minimal executable guidance for the core steps — e.g., a short terraform block or the exact gcloud/terraform commands for provider setup and endpoint deployment, or explicitly direct Claude to run `scripts/init-terraform.sh` at the start of the workflow.

Make the validation loop explicit: insert `terraform validate` and `terraform plan` checkpoints before apply, specify how to test endpoints after deployment (e.g., a curl against the predict URL), and reference references/errors.md as the fix-and-retry path.

Fix navigation: replace the vague "See Terraform implementation details" with a real link to [references/implementation.md](references/implementation.md), remove the broken ${CLAUDE_SKILL_DIR}/vertex-examples/ pointer and the URL-less "Vector Search guide:" bullet, and mention scripts/init-terraform.sh where it is meant to be used.

DimensionReasoningScore

Conciseness

The body is lean and list-driven with no explanations of concepts Claude already knows ("Provision Vertex AI infrastructure with Terraform (endpoints, deployed models, vector search indices, pipelines)"). Minor trimmable instances remain: the Overview paragraph largely restates the frontmatter description, the prerequisite "Understanding of Vertex AI services and ML models" adds nothing actionable, and "See Terraform implementation details for output format specifications" is filler without a path. This sits between anchor 3 (some unnecessary explanation) and anchor 4 (minor over-explanation), closer to 4 since nearly all padding is confined to a few bullets.

4 / 5

Actionability

The eight instruction steps are high-level hints with no executable content anywhere in the body: "Configure Terraform: Set up backend and define project variables", "Apply KMS encryption to endpoints and data", "Set up Cloud Monitoring for model performance" name topics but give no commands, code, variables, or resource examples. This matches anchor 2 (minimal concrete guidance; high-level hints missing the specific steps to execute) rather than anchor 3, because there is not even partial pseudocode or a concrete fragment — all specifics are deferred to reference files, and the bundled scripts/init-terraform.sh is never invoked.

2 / 5

Workflow Clarity

The 8-step sequence is ordered and ends with "Validate Deployment: Test endpoints and verify model availability", so a sequence and a nominal validation checkpoint exist, but the checkpoint is implicit and unspecified (no terraform validate/plan before apply, no test command, no fix-and-retry loop). This matches anchor 3 (steps listed but validation gaps; checkpoints missing or implicit); it does not reach anchor 4 because for a Terraform provisioning workflow the plan/apply validation loop is a core checkpoint, not a minor gap.

3 / 5

Progressive Disclosure

References are one level deep and the body correctly defers detail to files ([`references/errors.md`], [`references/examples.md`]), but scored against the actual bundle: "See Terraform implementation details for output format specifications" points to references/implementation.md without a link or path, references/ARD.md, references/PRD.md, and scripts/init-terraform.sh are undiscoverable from SKILL.md, the ${CLAUDE_SKILL_DIR}/vertex-examples/ pointer targets a directory that does not exist, and the "Vector Search guide:" bullet has no URL. This matches anchor 3 (references present but not clearly signaled); the broken and orphaned pointers are more than the minor gaps of anchor 4.

3 / 5

Total

12

/

20

Passed

Description

87%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 strong: it explicitly states what the skill provisions, includes five concrete trigger phrases, uses third person, and occupies a distinct niche. The only flaws are cosmetic — the garbled opening "Execute use when provisioning" reads as a leftover editing artifact, and "production AI services" is mild padding.

DimensionReasoningScore

Specificity

"Provisions Model Garden models, Gemini endpoints, vector search indices, ML pipelines, and production AI services with encryption and auto-scaling" enumerates several specific, concrete capabilities. It falls short of anchor 5 because "production AI services" is generic filler and all capabilities hang off the single verb "Provisions" with attribute clauses, whereas the 5 anchor shows varied concrete actions with comprehensive coverage.

4 / 5

Completeness

Both parts are explicit: the "what" is "Provisions Model Garden models, Gemini endpoints, vector search indices, ML pipelines..." and the "when" is stated twice — "use when provisioning Vertex AI infrastructure with Terraform" and "Trigger with phrases like 'vertex ai terraform', 'deploy gemini terraform', ...". This matches anchor 5 (clearly and explicitly answers both what AND when with concrete trigger phrases); the cap for a missing use-when clause does not apply.

5 / 5

Trigger Term Quality

The explicit triggers — "vertex ai terraform", "deploy gemini terraform", "model garden infrastructure", "vertex ai endpoints terraform", "vector search terraform" — are natural user phrasings covering the main sub-domains. It sits at anchor 4 (good keyword coverage; a few natural terms missing) rather than 5 because common variants like "gcp/google cloud ai infrastructure", "terraform vertex ai module", or "provision/deploy model endpoints" are absent.

4 / 5

Distinctiveness Conflict Risk

"provisioning Vertex AI infrastructure with Terraform" with triggers like "model garden infrastructure" and "vector search terraform" carves out a clear niche unlikely to fire for unrelated skills. Matches anchor 5 (clear niche with distinct triggers; minimal conflict risk); anchor 4 would require notable overlap with a closely related skill, which is not evident.

5 / 5

Total

18

/

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/devops/jeremy-vertex-terraform/skills/vertex-infra-expert/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.