CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-tooling

gh, vercel, supabase, render CLI and deployment platform setup

53

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/project-tooling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 content is highly actionable — every section delivers executable commands, scripts, and config covering the real deployment workflow. Its weaknesses are length (much of the CLI reference duplicates what Claude already knows) and the absence of validation checkpoints around risky operations like remote database pushes. As a single ~450-line file with no bundle structure, it also misses the opportunity to move the verification script and CI/CD examples into scripts/ and references/ files.

Suggestions

Trim sections that restate standard CLI usage Claude already knows (basic gh repo, supabase start/stop, vercel deploy commands) and keep only project-specific conventions like the platform-selection table, the checklist, and the anti-patterns.

Add validation steps around risky operations, e.g., 'supabase db push --dry-run' before the real push and a post-deploy status check, to close the workflow-clarity gap.

Move the inlined verification script to scripts/verify-tooling.sh and the CI/CD workflow YAML to references/ files, keeping SKILL.md as a concise overview that points to them.

DimensionReasoningScore

Conciseness

The body is mostly a lean command catalog with no conceptual padding, but it is ~450 lines in which large sections (gh repo create, supabase start/stop/reset, vercel deploy basics) restate standard CLI usage Claude already knows. It matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — a 2 would require padded prose explanations, and a 4 would require trimming the obvious-command sections down to project-specific conventions.

3 / 5

Actionability

The content is fully executable and copy-paste ready: complete verification commands per tool, a whole working bash validation script, working GitHub Actions YAML, a render.yaml example, and a package.json scripts block. Specific examples cover the common cases, matching the top anchor; the few placeholders (<org-id>, <service-id>) are appropriate parameterization rather than gaps.

5 / 5

Workflow Clarity

Sections are sequenced (verify tools → repo setup → deploy → migrations → CI/CD) and the verify-tooling.sh script acts as a checkpoint, but batch/destructive operations lack validation steps: 'supabase db push' applies migrations to remote with no dry-run or verify step, and the branch protection PUT has no confirmation check. Per the rubric's cap for database/batch operations without validation, workflow clarity cannot exceed 3; it is not a 2 because the Render setup does have an explicit numbered 5-step sequence and the platform-selection table gives a clear decision path.

3 / 5

Progressive Disclosure

The body has clear, well-organized section headers that make a single-file skill navigable, but at ~450 lines it inlines content that clearly belongs in bundle files — a full bash script labeled 'scripts/verify-tooling.sh' and complete CI/CD workflow YAML — with no references/ or scripts/ files present. This matches 'Some structure but could be better organized... content that should be separate is inline'; it is not a 2 because headers keep it navigable, and not a 4 because no external files or signaled references exist at all.

3 / 5

Total

14

/

20

Passed

Description

56%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 identifies its niche through concrete tool names, giving it decent trigger terms and distinctiveness, but it reads as a topic label rather than a capability statement. It lacks both concrete actions and any 'when to use' trigger guidance, leaving completeness and specificity as the weak spots.

Suggestions

Rewrite as a verb-led capability statement listing concrete actions, e.g., 'Sets up GitHub, Vercel, Supabase, and Render tooling: creates repos, configures deploys, manages database migrations and environment variables.'

Add an explicit trigger clause to the description, e.g., 'Use when setting up deployment, CI/CD, or when the project needs gh, vercel, supabase, or render CLI tools.'

Include natural synonyms and variations users would say (deploy, CI/CD, GitHub Actions, hosting) alongside the tool names to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names four concrete tools ('gh, vercel, supabase, render CLI') but the only action stated is the generic 'setup', matching the anchor 'Names the domain but actions are minimal or generic'. It is above a 1 because the tool enumeration is concrete, but below a 3 because no specific actions (e.g., create repos, deploy, run migrations) are listed.

2 / 5

Completeness

The description conveys a 'what' (CLI and deployment platform setup) but contains no 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 3. It does not score 4 because the 'what' is a vague noun fragment rather than a clear capability statement, and it does not score 2 because the enumerated tools do identify the skill's scope.

3 / 5

Trigger Term Quality

'gh', 'vercel', 'supabase', 'render', 'CLI', and 'deployment platform' are terms a user would naturally say when needing this skill, giving good keyword coverage. It falls short of 5 because common variations like 'CI/CD', 'GitHub Actions', 'hosting', and 'pipeline' are absent from the description.

4 / 5

Distinctiveness Conflict Risk

Naming four specific platforms (gh, vercel, supabase, render) gives the description a clear niche with minimal conflict risk against unrelated skills. It is not a 5 because 'CLI and deployment platform setup' is broad enough to overlap with generic git, CI, or infrastructure skills.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

alinaqi/maggy

Path

skills/project-tooling/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.