CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit-cli

Index and query a local checkout offline with the GitLab Orbit CLI (`orbit`, or `glab orbit`). Reach for it when a question names a symbol or spans code structure. Examples: who calls or extends this, where it is defined, what a file defines, how definitions are distributed. One call replaces many file reads and text greps, including matches in config, templates, and docs. Works on the working tree and unpushed branches, and also searches and reads the project's GitLab. Not a fit: reading one known file, or counts and relationships across GitLab (use the `orbit` skill).

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

82%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 efficient, highly actionable CLI reference with excellent token economy and concrete executable examples throughout. The main defects are navigation/consistency issues: a promised query-language section for `orbit query` that never materializes, and a mismatched link path in the References table.

Suggestions

Resolve the dangling promise in "Choose the command": either include the `orbit query` language in the body, point to a reference file that contains it, or drop the "Write the query in the language below" sentence (currently no query language exists in SKILL.md or references/local/cli.md).

Fix the References table link text so it matches the actual path: [`references/local/cli.md`](references/local/cli.md) instead of `references/cli.md`.

Consider moving the detailed grep-semantics rules (kind qualifiers, `file:`/`dir:` filters, widening behavior) into a reference file to keep SKILL.md as a lean overview, consistent with the existing cli.md pattern.

DimensionReasoningScore

Conciseness

The body is dense, terse, and information-rich with zero padding: it assumes Claude's competence and packs only non-obvious behavioral details (exit code 75, lock semantics, `--yes` placement rules, rg-style output format, kind qualifiers). No concept Claude already knows is explained, matching the 'lean and efficient; every token earns its place' anchor rather than the 4 anchor, which requires trimmable over-explanation.

5 / 5

Actionability

Guidance is overwhelmingly executable: concrete copy-paste shell commands (`orbit grep "method:rate limit" src`, `glab orbit --yes grep "..."`, `orbit context mr:42 ...`) with specific flags and behaviors. It falls short of the 5 anchor because of a real gap: the "Choose the command" section introduces `orbit query` with "Write the query in the language below", but no query language appears anywhere in the body or in the single reference file, and the References table link text (`references/cli.md`) does not match the actual path (`references/local/cli.md`).

4 / 5

Workflow Clarity

The core find-then-read workflow (grep → context) is unambiguous with worked examples, command selection is guided by the "Choose the command" section, and the "Fix inaccurate guidance" section has a clear confirm-then-act sequence. Above the 3 anchor because sequences and edge-handling (stale index, async indexing) are explicit; below the 5 anchor because one of the three advertised commands (`orbit query`) has no documented usage, leaving that branch of the decision flow undefined.

4 / 5

Progressive Disclosure

Good structure overall: a focused overview, clearly signaled one-level-deep reference to a real file (`references/local/cli.md`), and a References table for navigation. Not the 5 anchor due to minor gaps: the table's link text says `references/cli.md` while the target is `references/local/cli.md`, and ~50 lines of grep-query semantics are inlined in SKILL.md where the pattern of pointing to a reference file is already established.

4 / 5

Total

17

/

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.

A strong description: concrete capabilities, explicit positive and negative triggers phrased in natural user language, and clear separation from the sibling `orbit` skill. Third-person voice is maintained throughout. The only weakness is minor: a few natural synonyms (e.g., 'find references', 'usages') are absent.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Index and query a local checkout offline", "One call replaces many file reads and text greps", "also searches and reads the project's GitLab" — with concrete query examples ("who calls or extends this, where it is defined, what a file defines"). Coverage is comprehensive, including where the tool works ("working tree and unpushed branches") and where it does not. Not the 4 anchor because there are no meaningful gaps: both local and GitLab capabilities, plus exclusions, are enumerated.

5 / 5

Completeness

Both what and when are answered explicitly and concretely: what — indexing/querying a checkout offline via `orbit`/`glab orbit` replacing greps; when — "Reach for it when a question names a symbol or spans code structure" with example questions, plus an explicit negative trigger ("Not a fit: reading one known file, or counts and relationships across GitLab"). The negative guidance exceeds the 4 anchor's 'when could be more explicit'.

5 / 5

Trigger Term Quality

Natural trigger phrases are well represented: "when a question names a symbol or spans code structure", "who calls or extends this", "where it is defined". Missing a few common synonyms a user might say ("find references/usages", "code search") and any file-extension or command-name triggers beyond the tool's own, which keeps it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The tool is named specifically (GitLab Orbit CLI / `orbit` / `glab orbit`), is explicitly distinguished from plain file reads and greps, and explicitly routes GitLab-wide aggregation to the separate `orbit` skill. Clear niche, minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 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

relative_links

Relative link issues: 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 3 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

gitlabhq/orbit-knowledge-graph

Path

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