CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

setup-deploy

Configure deployment settings for /land-and-deploy. Detects your deploy platform (Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions, custom), production URL, health check endpoints, and deploy status commands. Writes the configuration to CLAUDE.md so all future deploys are automatic. Use when: "setup deploy", "configure deployment", "set up land-and-deploy", "how do I deploy with gstack", "add deploy config".

Quality

75%

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 ./skills/gstack/.agents/skills/gstack-setup-deploy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 deploy-configuration workflow itself is well-sequenced and largely executable, with good platform coverage and explicit verification. However, the body is dominated by generic gstack framework boilerplate (persona, onboarding prompts, telemetry) that inflates token cost and belongs in shared reference files rather than this skill.

Suggestions

Move the generic framework sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, Telemetry, Plan Status Footer) into a shared gstack reference file and keep SKILL.md focused on the deploy-configuration workflow, which would roughly halve the body's token cost.

Compress the preamble's onboarding dialogs (lake intro, telemetry/proactive prompts) into a short conditional pointer instead of fully scripted multi-question flows inline.

Add concrete extraction commands for Render (service name/type) and Netlify (site info), plus a detection step or user question that gathers the 'Merge method' field the Step 4 config template requires.

DimensionReasoningScore

Conciseness

Roughly 60% of the ~510-line body is generic framework boilerplate unrelated to deployment configuration — the 'Voice' persona section ('You are GStack, an open source AI builder framework shaped by Garry Tan's product, startup, and engineering judgment'), telemetry onboarding dialogs, 'Contributor Mode', 'Completeness Principle' effort tables, and the 'Plan Status Footer'. The actual skill instructions (Steps 1-6) are efficient, but the volume of padded, non-task sections places this at 'noticeably verbose; several unnecessary explanations or padded sections' rather than 'mostly efficient'.

2 / 5

Actionability

The core workflow is mostly executable with copy-paste commands: 'grep -A 20 "## Deploy Configuration" CLAUDE.md', 'grep -m1 "^app" fly.toml | sed 's/app = "\(.*\)"/\1/'', and 'curl -sf "{health-check-url}" -o /dev/null -w "%{http_code}"'. Minor gaps keep it from 5: Render says 'Extract service name and type from render.yaml' with no command, Netlify says only 'Extract site info from netlify.toml', and the required 'Merge method' field is never gathered by any detection step or question.

4 / 5

Workflow Clarity

The six steps (check existing config → detect platform → platform-specific setup → write → verify → summary) are clearly sequenced, with an explicit verification checkpoint in Step 5 and confirmation gates ('Always show the detected config and ask for confirmation before writing'). It falls short of 5 because error handling is 'note it but don't block' rather than a validate-fix-retry feedback loop, and platform branches like 'GitHub Actions only' leave the user to 'read the workflow file' without a defined checkpoint.

4 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), so everything lives in one monolithic SKILL.md. Section headers are clear, but ~200 lines of content that clearly belongs in shared reference files — the gstack-wide Voice rules, AskUserQuestion format, telemetry flows, and Plan Status Footer — are inlined in this skill-specific file, matching 'some structure... content that should be separate is inline'.

3 / 5

Total

13

/

20

Passed

Description

83%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 that clearly states what the skill does (platform/URL/health-check/status detection persisted to CLAUDE.md) and when to use it via five concrete trigger phrases. The only deductions are a second-person possessive ('your deploy platform') and minor trigger-synonym and overlap gaps.

DimensionReasoningScore

Specificity

The description lists comprehensive concrete actions — 'Detects your deploy platform (Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions, custom), production URL, health check endpoints, and deploy status commands' and 'Writes the configuration to CLAUDE.md' — matching the level-5 anchor. However, 'Detects your deploy platform' uses the second-person possessive, so the rubric's 1-point voice penalty on specificity applies, dropping it to 4.

4 / 5

Completeness

It explicitly answers both what ('Configure deployment settings for /land-and-deploy... Writes the configuration to CLAUDE.md so all future deploys are automatic') and when ('Use when: "setup deploy", "configure deployment"...') with concrete trigger phrases, exactly matching the level-5 anchor. Not 4 because the 'when' is fully explicit with quoted trigger phrases rather than merely present.

5 / 5

Trigger Term Quality

The 'Use when' clause provides five natural phrases users would actually say: "setup deploy", "configure deployment", "set up land-and-deploy", "how do I deploy with gstack", "add deploy config". Coverage is good but misses common variations like "deployment settings", "set up deployment", or platform-specific triggers, so it sits at the 'good keyword coverage; a few natural terms missing' anchor rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

It has a clear niche — persisting deploy configuration to CLAUDE.md for the /land-and-deploy workflow — with distinct triggers. Minor overlap risk remains with the closely related /land-and-deploy skill itself, since the trigger "how do I deploy with gstack" could plausibly invoke that skill instead, fitting the 'mostly distinct; minor overlap risk with closely related skills' anchor.

4 / 5

Total

17

/

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 (522 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-setup-deploy/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.