CtrlK
BlogDocsLog inGet started
Tessl Logo

setup-osn

Use when setting up or repairing a development environment for this repository on a machine — Bun at the pinned version, the GitHub CLI and its auth, SSH commit signing and the recommended git config, workspace dependencies, lefthook hooks and the portless dev proxy — and verifying it with the type-check, lint and format gates. Also the place to start when bun, gh, turbo or a hook is missing or the wrong version.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 disciplined procedural skill: concrete executable commands at every step, pre-handled failure modes (no sudo, no network, non-macOS), explicit validation gates, and a staleness-avoidance design that reads pinned values from the tree rather than hardcoding them. The main improvement space is trimming the two long Step 7 paragraphs and moving hook/bare-root detail into a referenced file.

Suggestions

Move the lefthook pre-commit/pre-push behavior description ("as of this writing pre-commit runs oxlint and oxfmt in write mode with stage_fixed…") into a short referenced file or a pointer to lefthook.yml, both to cut tokens and to remove time-sensitive content from the main body.

Split the Step 7 bare-root/bootstrap-bare-root explanation into its own section or reference file — it is the longest inline digression and interrupts the install-and-verify flow.

Consider a one-line 'Troubleshooting' pointer (e.g. to scripts/setup.sh or a reference note) so the not-macOS/no-sudo/no-network fallbacks remain but the body reads even leaner.

DimensionReasoningScore

Conciseness

The body is dense and command-first with almost no explanation of concepts Claude already knows ("Simpler than GPG" is the only aside, one line), and it deliberately outsources versions to the tree ("versions live there, not here"). It is not a 5 because a few passages could be trimmed — the long bare-root/bootstrap paragraph in Step 7 and the time-sensitive "as of this writing pre-commit runs oxlint and oxfmt…" hook description, which the guidelines penalize inline.

4 / 5

Actionability

Every step gives copy-paste-ready commands: `curl -fsSL https://bun.sh/install | bash -s "bun-v$(cat .bun-version)"`, the `printf` allowed-signers snippet, the git-config table with exact check/apply commands, `bash scripts/setup.sh`, and the portless commands. Non-macOS fallbacks cover the common cases, matching the 5 anchor's fully-executable, common-cases-covered standard.

5 / 5

Workflow Clarity

Nine clearly sequenced steps, each with a check command, a fallback, and an explicit verification path (the three gates in Step 7); feedback loops are present ("If a gate fails, paste the shortest decisive lines into the table and keep going", "Verify again"), and the guardrail "Never claim a gate passed that did not run here" plus the required report table give it the error-recovery discipline of the 5 anchor. Not a 4: no validation checkpoints are missing.

5 / 5

Progressive Disclosure

Well-sectioned body that pushes detail one level deep into clearly signaled repo files (`.bun-version`, `lefthook.yml`, `CLAUDE.md` §Local URLs, `scripts/setup.sh`) instead of duplicating it, and there are no nested or dead references. It is not a 5 because the ~110-line body carries all detail inline with no separate reference files — the lefthook/pre-push behavior description and the bare-root explanation in Step 7 are exactly the kind of content that could live in a referenced file, and the simple-skill exception (under 50 lines) does not apply.

4 / 5

Total

18

/

20

Passed

Description

92%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.

An exemplary description: explicit "Use when" triggers, a comprehensive and concrete inventory of what gets set up and verified, distinctive tool-specific terms, and correct third-person voice. The only minor gap is a few missing natural synonyms ("install", "new machine") that keeps trigger coverage just short of comprehensive.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities: "Bun at the pinned version", "the GitHub CLI and its auth", "SSH commit signing", "the recommended git config", "workspace dependencies", "lefthook hooks and the portless dev proxy", plus the verification gates ("type-check, lint and format"). This matches the 5 anchor's comprehensive coverage of specific actions; it is not the 4 anchor because there are no meaningful coverage gaps in what the skill does.

5 / 5

Completeness

Explicitly answers both questions: "Use when setting up or repairing a development environment for this repository on a machine" (when) followed by a full component inventory and the verification gates (what), plus a second explicit trigger sentence. This mirrors the 5 anchor's "what AND when with concrete trigger phrases"; the 4 anchor's "'when' could be more explicit" does not apply since the trigger clause is unambiguous.

5 / 5

Trigger Term Quality

Good natural-term coverage — users would plausibly say "bun", "gh", "turbo", "hook", "development environment", "set up" — and the second sentence ("when bun, gh, turbo or a hook is missing or the wrong version") adds failure-mode triggers. It falls short of the 5 anchor because common synonyms like "install", "onboarding", or "new machine setup" are absent ("on a machine" is the closest), so a few natural phrasings would not match.

4 / 5

Distinctiveness Conflict Risk

A clear niche — repo-scoped environment setup ("for this repository") with distinctive tool names (Bun, lefthook, portless, turbo) that few other skills would claim. Not the 4 anchor: the named toolchain and repo-specific framing leave essentially no overlap with neighboring skills.

5 / 5

Total

19

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

15

/

16

Passed

Repository
englishstventures/osn
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.