CtrlK
BlogDocsLog inGet started
Tessl Logo

setup-dev

Set up and manage the Sentry development environment using devenv. Handles fresh setup, updating existing environments, starting dev services, resetting the database, per-worktree environment setup (each worktree needs its own devenv sync/.venv), and troubleshooting. Use when asked to "set up sentry", "setup dev environment", "get sentry running", "start dev server", "devenv setup", "devservices not working", "sentry won't start", "reset the database", "new worktree venv/devenv setup", or any development environment issue.

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 highly actionable, well-sequenced setup guide with mostly lean command-driven content and a properly signaled one-level-deep reference. The main gap is the absence of validation/confirmation around its destructive operations (reset-db, docker rm -f, purge), which caps workflow clarity, alongside some duplication between the steps and the troubleshooting table.

Suggestions

Add validation/confirmation checkpoints around destructive operations: e.g., warn what `make reset-db` and `devservices purge` delete, confirm before running, and verify success afterwards (check dev server loads, `docker ps`) — this would lift workflow_clarity past the destructive-operations cap.

Move the OrbStack socket workaround detail from Step 6 into the existing references/orbstack-fix.md (keeping only the symptom and a pointer), reducing main-file length and duplication with the troubleshooting table.

Relocate the time-sensitive devenv version threshold ("< 1.22") into a dedicated maintained/versions note, and deduplicate fixes that appear both in the step-by-step flow and the troubleshooting decision tree.

DimensionReasoningScore

Conciseness

The body is dense with executable commands and set-expectation callouts with little conceptual padding, matching the level-4 'efficient; minor instances that could be trimmed'. It falls short of level 5 because the troubleshooting decision table duplicates several fixes already explained in the steps, and the time-sensitive version threshold "e.g., < 1.22" sits inline rather than in a dedicated section, which the guidelines penalize.

4 / 5

Actionability

Every step gives copy-paste-ready commands — install scripts, `devenv sync`, `devservices up`, `.venv/bin/sentry upgrade --noinput` — plus concrete verification commands, URLs, and login credentials. The OrbStack section even names the exact source file and grep to locate the bug. This is the level-5 'fully executable, covers the common cases' anchor; level 4 would imply gaps in executable detail.

5 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with state detection up front and checkpoints like `docker info`, `devenv --version`, and `devenv doctor`. However, the skill contains destructive operations — `make reset-db`, `docker rm -f $(docker ps -aq)`, and the nuclear `devservices purge` — with no validation or confirmation steps around them, which the guidelines explicitly cap at 3 even though the sequence otherwise merits 4-5.

3 / 5

Progressive Disclosure

The single bundle reference (`references/orbstack-fix.md`) is real, one level deep, and clearly signaled from the body ("Read references/orbstack-fix.md for the exact pattern"), and the top-level body uses well-organized sections. It is not level 5 because some OrbStack-socket troubleshooting detail is inlined in Step 6 that would fit better in the existing reference, and no other troubleshooting depth is offloaded despite the long main file.

4 / 5

Total

16

/

20

Passed

Description

96%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 capability list, and an explicit 'Use when' clause with many natural trigger phrases. The only weakness is the broad final catch-all phrase, which slightly raises conflict risk with other development-environment skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Handles fresh setup, updating existing environments, starting dev services, resetting the database, per-worktree environment setup... and troubleshooting" — with comprehensive coverage of the skill's surface. It matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level-4 anchor since there are no meaningful coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is the full capability list in first sentence, and the 'when' is an explicit "Use when asked to..." clause with concrete trigger phrases. This is the level-5 anchor verbatim in structure; it clearly exceeds level 4, where the 'when' would be less specific.

5 / 5

Trigger Term Quality

Ten quoted natural trigger phrases users would actually say ("set up sentry", "sentry won't start", "devservices not working", "reset the database") plus a catch-all. This matches the comprehensive synonym coverage of the level-5 anchor; it is well above the level-4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The Sentry/devenv niche is clear and specific triggers (devenv, devservices, sentry) are distinctive, but the trailing catch-all "or any development environment issue" broadens it to overlap with other dev-environment skills. That is minor overlap risk (level 4), not the level-5 'minimal conflict risk' since a generic dev-env request could route here.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
getsentry/sentry
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.