CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

understand-onboard

Use when you need to generate an onboarding guide for new team members joining a project

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.

The body is a well-sequenced, highly actionable workflow: concrete shell and git commands, exact graph fields to extract, explicit freshness validation with graceful non-blocking fallbacks, and a clear output template. Only minor tightening of the freshness-check prose is possible.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it documents only the project-specific graph schema and gives terse operational directives with no filler — but the freshness-check prose in step 2 and the triple node-type enumeration could be trimmed slightly, matching anchor 4 rather than anchor 5's every-token-earns-its-place standard.

4 / 5

Actionability

Every step is executable: a copy-paste shell one-liner for resolving $UA_DIR, a complete copy-paste git validation block, exact JSON keys to Grep ("project", "layers", "tour"), the exact node types and fields to extract, and a named section template for the output guide — matching anchor 5 ("copy-paste ready code or commands").

5 / 5

Workflow Clarity

Eleven clearly sequenced steps with explicit validation checkpoints and error-recovery fallbacks: step 1 verifies knowledge-graph.json exists and tells the user to run /understand if not; step 2 resolves the graph commit, checks staleness with concrete diffs, and degrades gracefully when git metadata is missing or invalid — matching anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed; the ~65-line body is cleanly organized into Graph Structure Reference, How to Read Efficiently, and Instructions, with all content appropriately inline for a skill of this size — matching the well-organized-structure criterion for anchor 5.

5 / 5

Total

19

/

20

Passed

Description

68%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 is clear and occupies a distinct niche with a natural trigger scenario, but it is written in second person ("you need"), lists only one concrete action, and its "when" clause restates the "what" rather than adding separate trigger phrases.

Suggestions

Rewrite in third person, e.g. "Generates an onboarding guide from the project knowledge graph. Use when onboarding new team members or creating onboarding documentation."

Add 1-2 more concrete outputs (e.g. architecture layers, file map, complexity hotspots) to raise specificity beyond a single action.

Include trigger variations such as "onboard", "new developers", or "ramp up" to broaden natural keyword coverage toward anchor 5.

DimensionReasoningScore

Specificity

"generate an onboarding guide for new team members joining a project" names the domain and one concrete action, which matches anchor 3, but the description is written in second person ("Use when you need to"), which the judging guidelines penalize by reducing the specificity score by 1. It does not reach anchor 4 since only a single action is listed.

2 / 5

Completeness

Both what ("generate an onboarding guide") and when ("Use when you need to...") are explicitly present, but the "when" clause largely restates the "what" instead of adding independent trigger scenarios, so it matches anchor 4 rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

"onboarding guide", "new team members", and "joining a project" are natural phrases a user would say when they need this skill, matching anchor 4 ("good keyword coverage; a few natural terms missing"). It falls short of anchor 5 because variations like "onboard", "new hires", or "ramp up" are absent.

4 / 5

Distinctiveness Conflict Risk

"onboarding guide for new team members joining a project" is a clear niche with distinct triggers and minimal overlap with other skills, matching anchor 5; it is more specific than anchor 4's example of closely related formats sharing triggers.

5 / 5

Total

15

/

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

Egonex-AI/Understand-Anything

Path

understand-anything-plugin/skills/understand-onboard/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.