CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit

Malformed remote markers

Quality

27%

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

Fix and improve this skill with Tessl

tessl review fix ./crates/orbit-cli/tests/fixtures/skills/malformed-remote/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

22%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 not functional skill content: it consists of a heading and a malformed include marker with stray trailing text, referencing a quick-start resource that doesn't exist in the bundle. While nothing is wasted on verbosity, the skill provides zero actionable guidance, no workflow, and broken navigation.

Suggestions

Replace the malformed marker with real instructions or a proper link to an existing bundle file under references/.

Add the actual quick-start steps the marker alludes to, as concrete executable commands or guidance.

If the skill involves multi-step or batch operations, sequence the steps explicitly and include a validation checkpoint.

DimensionReasoningScore

Conciseness

The body ("# Remote" plus "<!-- orbit:include local:quick-start --> trailing text") is brief with no padded explanations of concepts Claude already knows, sitting between the lean level-5 anchor and level 4. It scores 4 rather than 5 because the malformed marker and its trailing text are noise tokens that earn no place.

4 / 5

Actionability

There is no concrete guidance, code, or command anywhere — the only content is a broken include directive pointing to a "local:quick-start" resource that does not exist in any bundle directory. This matches the level-1 anchor "Entirely vague or abstract; no concrete code or commands".

1 / 5

Workflow Clarity

No steps or sequence of any kind are present, matching "Steps missing or incoherent; no sequence; no validation". It does not reach level 2 because not even a rough sequence exists.

1 / 5

Progressive Disclosure

The single reference ("orbit:include local:quick-start") is a dangling pointer to a nonexistent file — there are no references/, scripts/, or assets/ directories — making the content impossible to navigate, which matches the level-1 anchor's "impossible to navigate" condition.

1 / 5

Total

7

/

20

Passed

Description

0%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 fails every dimension: it appears to be a diagnostic label ("Malformed remote markers") rather than a functional skill description. It communicates no capabilities, no trigger conditions, and no domain, making it impossible for a user or model to know when this skill applies.

Suggestions

Rewrite the description in third person to state 2-4 concrete actions the skill performs (e.g., what it actually does with remote resources or markers).

Add an explicit "Use when..." trigger clause listing natural phrases and file types a user would mention when needing this skill.

Include domain-specific keywords and synonyms so the skill is distinguishable from unrelated skills and matches real user requests.

DimensionReasoningScore

Specificity

The description is only "Malformed remote markers" — it names no domain and no concrete actions whatsoever, matching the anchor "Entirely vague; no concrete actions; pure abstract language" (like "Helps with documents"). It does not reach level 2 because it doesn't even name a domain of operation.

1 / 5

Completeness

Neither "what does this do" nor "when to use it" is present in any form; there is no "Use when..." clause or equivalent (which alone would cap this dimension at 3), matching the level-1 anchor "Missing both what and when".

1 / 5

Trigger Term Quality

There are no natural keywords a user would say when needing this skill — the phrase reads as an internal status label rather than user language, matching the level-1 anchor "No natural keywords; only technical jargon or entirely generic language".

1 / 5

Distinctiveness Conflict Risk

The description is entirely generic/meaningless for triggering purposes and conveys no niche, matching "Entirely generic; would conflict with virtually any skill". It cannot be reliably matched to any user request.

1 / 5

Total

4

/

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

crates/orbit-cli/tests/fixtures/skills/malformed-remote/SKILL.md

Revision

ed321d9

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill