CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

contributor-onboarding

Help a new contributor get productive on this checkout - inspect sync state against main, build, run the repository's exact verification gate, and produce a local what's-new digest. Never fetches, pulls, or modifies a dirty tree on its own. Explicit-only.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary instruction-only skill body: exact commands, a strictly ordered workflow with real validation gates, and disciplined honesty rules ('unavailable' over guessing). The only blemish is slight duplication of the attribution and a few meta sentences.

DimensionReasoningScore

Conciseness

Efficient overall — no explanations of concepts Claude already knows, and the command blocks carry the weight. Minor trims available: the @JayBeest attribution appears twice (intro and Credit section), and 'without a wall of prose' is meta-commentary. Not 5 because those few tokens could be trimmed; clearly above the 'mostly efficient but includes some unnecessary explanation' anchor.

4 / 5

Actionability

Fully executable throughout: exact git inspection commands, the exact cargo build invocation, the verbatim CI gate commands with all clippy allow-flags, the digest commands with explicit caps, and the dogfood smoke command. Reporting semantics ('not run' vs 'unavailable', 'Never write passed from inference') are concrete and copy-paste ready.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints and feedback loops: a build failure ends the run before the gate, the gate only runs after a successful build, dogfood only after the gate actually passed, dirty-tree recovery options are ordered and user-selectable, and staleness of the copied CI commands plus the known flaky test are both handled. Matches the 'clear sequence with explicit validation steps; feedback loops for error recovery' anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so nothing is inlined that belongs elsewhere; the only file mentions (.github/workflows/ci.yml, CHANGELOG.md) are inputs the skill reads, clearly signaled, one level deep. The single-file workflow is well organized into labeled sections, making navigation trivial for this self-contained single-purpose skill.

5 / 5

Total

19

/

20

Passed

Description

71%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 specific, honest description with concrete capabilities and a clear niche, written in third person. Its main weakness is the absence of any 'Use when...' trigger clause, leaving the invocation conditions implicit.

Suggestions

Append an explicit trigger clause, e.g. 'Use when a contributor has freshly cloned this repo, asks if they are current/up to date, or wants to know whether the build and tests pass.'

Add natural trigger synonyms users would say ('onboard', 'get started', 'catch up on this repo', 'first run') to improve trigger_term_quality.

Keep the safeguard sentence but consider folding 'Explicit-only' into the trigger clause so it clarifies when the skill applies, not just how it runs.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'inspect sync state against main, build, run the repository's exact verification gate, and produce a local what's-new digest' — which comprehensively covers the onboarding workflow. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; the safeguards ('Never fetches, pulls, or modifies a dirty tree on its own') add concrete behavioral boundaries rather than fluff.

5 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'Explicit-only' describes invocation mode, not when the skill applies, and the 'when' is only weakly implied by 'a new contributor'. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keywords — 'new contributor', 'checkout', 'sync state', 'build', 'verification gate', 'what's-new digest' — but common variations users would actually say are missing ('onboard me', 'get started', 'catch up', 'first-run setup'). Not the level-5 anchor, which requires comprehensive coverage including synonyms; above level 3 because most relevant trigger words are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (first-run contributor verification on this specific checkout) with distinct phrases like 'the repository's exact verification gate', giving minimal conflict risk. Not 5 because generic terms 'build' and 'sync' could overlap with plain git/build-helper skills, but well above the 'somewhat specific, could overlap' anchor.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

Hmbown/Codewhale

Path

crates/tui/assets/skills/contributor-onboarding/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.