CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit-start

Walk a user through their first GitLab Orbit session. Check the setup, then answer a simple first question and a workflow from the prompt examples with Orbit. Offer to run a prompt again without Orbit, and to show how Orbit works. Use when the user asks to get started with Orbit, try Orbit, or see what Orbit can do.

Quality

87%

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

85%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 highly actionable, well-sequenced onboarding script: exact commands, copy-paste prompts, and validation with error-recovery loops throughout, with no padding or basic-concept explanations. Its main weakness is progressive disclosure — a ~390-line monolith that inlines static prompt templates, diagrams, and a Python script that belong in separate reference or script files.

Suggestions

Move the transcript-counting Python script from step 4 into a bundled scripts/ file (e.g. scripts/count_usage.py) and invoke it with the start/end/path arguments, trimming ~35 lines from the always-loaded body.

Move the six fixed prompt-example blocks in step 3 into a one-level-deep references/prompts.md, loading them only when the user reaches step 3 and keeping only the bold labels and one-line summaries inline.

Move the five static "how Orbit works" parts (diagrams, explanations, and Read more links) in step 5 into a references/how-it-works.md so the main body stays a navigable session flow.

DimensionReasoningScore

Conciseness

The body is written as lean, imperative instructions with no explanations of concepts Claude already knows (no "what GitLab is", no "what a merge request is"), matching the 4-anchor ("Efficient; minor instances of over-explanation that could be trimmed"). It is not 5 because at ~390 lines it includes rationale sentences ("Shows that Orbit indexes your code, not only merge requests and pipelines"), a ~35-line inline Python script, and repeated option menus that could be tightened or externalized; it is not 3 because the prose itself is tight and every section is operational.

4 / 5

Actionability

Guidance is fully executable throughout: exact commands (`glab orbit status`, `glab orbit schema Project MergeRequest MergeRequestDiffFile Pipeline Job Vulnerability File Definition User`, `date -u +%Y-%m-%dT%H:%M:%SZ`), six copy-paste prompt templates with `<placeholder>` substitution rules, a runnable Python script for counting tool calls and tokens, and a concrete comparison-table template with worked examples ("14 callers in 6 projects"). This matches the 5-anchor: copy-paste ready commands covering the common cases.

5 / 5

Workflow Clarity

The session is sequenced as six numbered steps with numbered sub-steps, and validation with error-recovery loops is explicit: "If it fails, follow the entry for its exit code... and run `glab orbit status` again. If it still fails, tell the user what failed and stop", "If no project in the scope is indexed yet, tell the user, and ask for another scope", and "If a query returns no rows, say so". This matches the 5-anchor (clear sequence, explicit validation, feedback loops); the session is read-only and per-session scoped, so the destructive/batch cap does not apply, and the 4-anchor's "minor validation gaps" are not present.

5 / 5

Progressive Disclosure

Section structure is good (## per step, ### per part, working internal links like [Answer with Orbit](#answer-with-orbit)) and no bundle files are referenced (verified: references/, scripts/, assets/ do not exist). But roughly 200 lines of static content are inlined in the always-loaded SKILL.md — the six fixed prompt-example blocks in step 3, the five static "how Orbit works" walkthrough parts in step 5, and the transcript-counting Python script — which clearly belong in one-level-deep reference or script files. This matches the 3-anchor ("content that should be separate is inline"); it is not 4 because that bulk is more than a minor organization gap, and not 2 because the internal structure and navigation are solid.

3 / 5

Total

17

/

20

Passed

Description

87%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: it states what the skill does in concrete third-person actions and closes with an explicit, natural-language trigger clause, all anchored to a distinct product niche. The only deductions are minor — one uncovered skill step and a few missing trigger synonyms.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Walk a user through their first GitLab Orbit session", "Check the setup", "answer a simple first question and a workflow from the prompt examples", "Offer to run a prompt again without Orbit, and to show how Orbit works" — matching the 4-anchor ("several specific actions; minor gaps in coverage"). It is not 5 because the coverage has a gap: the skill's final step (offering next steps such as setting up Orbit for every session) is absent.

4 / 5

Completeness

Both halves are explicit: the "what" is concretely stated ("Walk a user through their first GitLab Orbit session. Check the setup, then answer a simple first question and a workflow from the prompt examples...") and the "when" is an explicit "Use when the user asks to get started with Orbit, try Orbit, or see what Orbit can do" with concrete trigger phrases. This matches the 5-anchor exactly; the 4-anchor ('when' could be more explicit) does not apply since the trigger guidance is fully explicit.

5 / 5

Trigger Term Quality

The when-clause gives natural phrases users would actually say: "get started with Orbit", "try Orbit", "see what Orbit can do" — good keyword coverage per the 4-anchor. It is not 5 because common synonyms and variations ("onboarding", "first time", "learn Orbit", "what is Orbit") are missing.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — GitLab Orbit first-session onboarding — and every capability and trigger phrase is qualified by "Orbit", so it would not fire for generic GitLab, glab, or knowledge-graph skills. This matches the 5-anchor (clear niche with distinct triggers; minimal conflict risk); the 4-anchor's minor overlap risk is not present.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

gitlabhq/orbit-knowledge-graph

Path

skills/orbit-start/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.