CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit-wrapper

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

86%

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

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 an exemplary thin-wrapper skill: fully executable commands, an explicit load-validation checkpoint, and concrete error-recovery branches for every failure mode. The only notable deduction is time-sensitive version troubleshooting embedded in the main flow rather than isolated in a deprecated-versions section.

Suggestions

Move the glab/Orbit CLI minimum-version troubleshooting (v1.94.0, v1.117.0, v0.126.0-v0.130.x) into a clearly labeled "Troubleshooting / old versions" section, or trim the version-range detail, since it is time-sensitive and partially duplicates the frontmatter compatibility field.

Tighten the fallback paragraph — "If the block above is not a skill... run `glab orbit skills get orbit`" repeats the command the `!` line already invokes — into a single sentence covering the case where auto-execution does not render a skill block.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (no concept explanations, every sentence adds non-obvious setup knowledge), but it embeds time-sensitive version numbers ("glab v1.94.0 or later", "v0.126.0 to v0.130.x") outside any deprecated/old-patterns section, and these partially duplicate the frontmatter compatibility field — a direct penalty trigger under the rubric's version-number guideline, so it cannot be a 5.

4 / 5

Actionability

All guidance is fully executable and copy-paste ready — "!`glab orbit skills get orbit`", "orbit skills get orbit" for the standalone binary, and "glab orbit skills get orbit <path>" for fetching referenced files — with concrete per-failure-mode actions (upgrade glab, upgrade the Orbit CLI to v0.131.0+, ask the user before installing).

5 / 5

Workflow Clarity

The load-then-verify flow has an explicit validation checkpoint ("If the block above is not a skill (it should begin with `---`)"), and enumerated error-recovery branches for each failure mode (manual rerun, standalone binary, version upgrade, ask-before-install) form a genuine feedback loop; no destructive or batch operations exist to trigger the validation cap.

5 / 5

Progressive Disclosure

This is a sub-50-line wrapper skill with no need for external references, and its sections are well organized; it even signals navigation into the loaded skill's bundle ("Links such as `references/recipes.md` ... Print them with `glab orbit skills get orbit <path>`"), which satisfies the simple-skill exception for a top score.

5 / 5

Total

19

/

20

Passed

Description

78%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 with concrete, distinct capabilities and explicit boundary guidance. Its main weakness is that the when-to-use side is defined only negatively ("Skip it for writes that `glab` handles"), with no positive "Use when..." clause or trigger synonyms such as "merge requests" or "knowledge graph".

Suggestions

Add a positive trigger clause, e.g. "Use when the user asks about a function's callers or tests, or wants the code cited by an MR, issue, or failed job", so the when-to-use is not defined only by exclusion.

Include natural trigger synonyms — "merge requests" spelled out, "knowledge graph", "call graph" — alongside the current "MRs" and "graph queries" keywords.

Name one or two concrete search outcomes (e.g., "find definitions, usages, and related tests") to round out the capability list toward full coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "search code and read it with callers and tests", "reads MRs, issues, and failed jobs with the code they cite", and "Graph queries answer relationship and aggregation questions" — which goes beyond the 1-2 actions of a score-3 anchor, but coverage has minor gaps (e.g., no concrete examples of what a search or graph query returns), so it falls short of the comprehensive coverage of a 5.

4 / 5

Completeness

The "what" is clearly stated, and "Skip it for writes that `glab` handles" provides explicit trigger guidance by defining the read/write boundary, so this is above the weakly-implied-when of a 3; however, there is no positive "Use when..." clause with concrete trigger phrases, keeping it below a 5.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("search code", "MRs", "issues", "failed jobs", "graph queries", "GitLab"), giving good keyword coverage, but common variations are missing — "merge requests" is only abbreviated, and terms like "knowledge graph", "call graph", or "callers of a function" never appear.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche tied to a specific tool ("Orbit (`glab orbit` or `orbit`)" with GitLab-specific triggers like MRs, failed jobs, and graph queries) and even disambiguates itself from plain `glab` write commands, so conflict risk is minimal.

5 / 5

Total

17

/

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

Warning

Total

13

/

16

Passed

Repository

gitlabhq/orbit-knowledge-graph

Path

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