CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit

Use Orbit (`glab orbit` or `orbit`) to search code and read it with callers and tests. It reads MRs, issues, and failed jobs with the code they cite. Graph queries answer relationship and aggregation questions across GitLab. Skip it for writes that `glab` handles.

Quality

82%

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

93%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 lean, highly actionable guide packed with non-obvious operational rules, executable examples, and well-signaled one-level-deep references that all verify against the actual bundle. Multi-step flows carry validation checkpoints and feedback loops (iteration budget, error routing, coverage-gap reporting); only the parallel-section organization and fully deferred recovery details keep workflow clarity at 4.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational rules (16-predicate counting semantics, '--yes' flag placement, ~40 KB unscoped schema output, no --jq support) and explains no concepts Claude already knows. Not 4 because there is no trimmable over-explanation — even the Managed CLI details are behavioral rules that prevent wrong invocation.

5 / 5

Actionability

Copy-paste ready throughout: the schema|jq pipeline, the PROJECT_ID resolution one-liner, a complete traversal query JSON with its invocation command, and install/config commands. Not 4 because the common case (running a traversal query) is fully executable end-to-end and failure paths route to concrete fixes.

5 / 5

Workflow Clarity

The query flow is coherent with checkpoints: failure routing to first-run setup, 'If rejected, remove redundant conditions or simplify the query', a 5-attempt iteration budget that includes validation errors, and reporting that must show coverage gaps. Not 5 because the workflows are presented as parallel topic sections rather than one explicit sequence, and full error-recovery rules and the repo-map invocation are deferred to references; not 3 because validation and feedback checkpoints are present at each failure point.

4 / 5

Progressive Disclosure

The overview keeps only common-use content and defers detail one level deep via verified real files (query_language.md, recipes.md, troubleshooting.md, reporting.md, remote_repo_map.md, maintaining.md) with anchor-precise links plus a References table for navigation. Not 4 because every inline pointer is well-signaled with descriptive context and navigation is easy; the only blemish is the illustrative 'references/local/cli.md' example path, which is not a real bundle file.

5 / 5

Total

19

/

20

Passed

Description

66%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 specific and distinct, naming concrete capabilities with several natural trigger terms and a useful negative boundary against glab write commands. Its main weakness is the missing positive 'Use when...' trigger clause, which caps completeness, along with abbreviated terms like 'MRs' and no mention of the skill's local-CLI capabilities.

Suggestions

Add an explicit positive trigger clause, e.g. 'Use when searching code for callers or covering tests in a GitLab project, reading an MR, issue, or failed job with the code it cites, or answering relationship/aggregation questions across GitLab data.'

Use full natural terms and synonyms: spell out 'merge requests' alongside 'MRs', and include variations such as 'find callers', 'find references', 'knowledge graph', and 'local code search' so users' phrasings match.

Mention the local-CLI capabilities covered in the body (local grep/context over the DuckDB graph, workspace indexing, repository map helper) so the description reflects the skill's full scope.

DimensionReasoningScore

Specificity

Lists several concrete actions ('search code and read it with callers and tests', 'reads MRs, issues, and failed jobs with the code they cite', 'Graph queries answer relationship and aggregation questions across GitLab'). Not 5 because the local-CLI half of the skill (local grep/context, workspace indexing, repository map helper) is omitted — a minor coverage gap; not 3 because it clearly names several specific actions rather than 1-2.

4 / 5

Completeness

The 'what' is clear across multiple concrete capabilities, but the only trigger guidance is negative ('Skip it for writes that glab handles') with no positive 'Use when...' clause or equivalent, so completeness is capped at 3 per the rubric guideline. Not 4 because 'when' remains only weakly implied; not 2 because the what is clear and an explicit skip-when boundary exists.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'search code', 'callers', 'tests', 'MRs', 'issues', 'failed jobs', 'aggregation'. Not 5 because common variations are missing — 'merge requests' appears only as the abbreviation 'MRs', and terms like 'knowledge graph', 'find references', or local code-search phrasings are absent; not 3 because several relevant natural terms beyond the bare domain name are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (GitLab Orbit graph queries, code reading with callers and tests) with an explicit boundary ('Skip it for writes that glab handles') separating it from plain glab usage. Not 5 because 'search code' and 'read MRs' still overlap with generic code-search or glab skills; not 3 because the Orbit/graph framing plus the explicit skip clause makes it mostly distinct.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

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

referenced_paths_exist

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

Warning

Total

13

/

16

Passed

Repository

gitlabhq/orbit-knowledge-graph

Path

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