CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit-github

Open Orbit briefing skill — selected by the Orbit pipeline when GitHub is the user's only connected connector, or when the user explicitly scopes their daily digest to GitHub. Pulls the past 24 hours of PRs, review requests, issues, CI runs, and merges from the user's authenticated GitHub connection and renders them in a layout that mirrors GitHub's native Notifications + PR-diff visual language. This skill should not be triggered manually — it is invoked by Orbit's daily-digest scheduler against live GitHub data.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 content is a tight, concrete design spec with a well-sequenced reproduction protocol and strong do/don't constraints. Its main weaknesses are the duplicated color values, the missing final validation step, and — most materially — that the canonical example.html the entire protocol depends on is not shipped in the bundle, leaving the source-of-truth instruction unverifiable.

Suggestions

Ship example.html in the skill bundle (or, if it cannot be shipped, inline the canonical DOM structure into SKILL.md) so step 1 of the source-of-truth protocol — 'Open and read the shipped example.html' — can actually be executed.

Remove the duplicated color values: the attention-block (#fff8c5/#d4a72c) and CI-fail (#cf222e/#ffebe9) hexes appear both in the Canvas tokens section and again in the Implementation constraints table — cite the token names in the table instead.

Add a short final self-check step to the protocol (e.g. 'Before finishing, diff your output against example.html: same nav items, same rail items, same group order and row counts, no additions') to close the workflow's validation gap.

DimensionReasoningScore

Conciseness

The body is dense and purposeful — exact hex tokens, pixel dimensions, structural specs, and a paired do/don't table, with no explanations of concepts Claude already knows. Minor over-explanation exists: the attention-block and CI-fail color values are stated in full in the token list and then repeated verbatim in the do/don't table, and the design-system policy repeats the 'ignore it' instruction three ways. Fits 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor at 5.

4 / 5

Actionability

Highly concrete instruction-only guidance — exact canvas tokens ("page bg: #f6f8fa", "nav bar: #24292f"), a type stack, section-by-section layout specs with counts and ordering, and prescriptive do/don't pairs ("Use nexu-io/open-design", "commit subjects under 72 chars"). It falls short of fully executable because the protocol's step 1 ("Open and read the shipped example.html") depends on a file that is not present in the bundle, so the canonical reference cannot actually be read; the inline spec partially compensates.

4 / 5

Workflow Clarity

A clear three-step sequence (read example.html → mirror structure 1:1 → refresh mock values without inventing UI) with explicit guardrails ("If something is not already present in example.html, it does not belong in your output") and an identity guard. This is a generation task, not a destructive/batch operation, so the validation cap does not apply; the gap keeping it below 5 is the absence of any final self-check against the example before finishing.

4 / 5

Progressive Disclosure

Section structure is good (protocol → policy → tokens → sections → rules → constraints), but the body's single and most important bundle reference — "Open and read the shipped example.html in this folder" — points to a file that does not exist in the bundle (no example.html, no references/, scripts/, or assets/). Per the guideline to score against the actual bundle structure, the one-level-deep reference is clearly signaled but dangling, so navigation breaks exactly where the skill routes all fidelity decisions.

3 / 5

Total

15

/

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.

The description is specific, explicit about both what it does and when it applies (including when it must NOT fire), and occupies a clear niche. Trigger-term coverage is good but lacks a few natural synonyms, which is the only dimension below the top anchor.

DimensionReasoningScore

Specificity

Concrete actions are enumerated precisely: "Pulls the past 24 hours of PRs, review requests, issues, CI runs, and merges" and "renders them in a layout that mirrors GitHub's native Notifications + PR-diff visual language" — multiple specific actions with concrete scope, matching the comprehensive-coverage anchor rather than the 'several actions, minor gaps' anchor at 4.

5 / 5

Completeness

What is answered explicitly (pull 24h of GitHub activity, render as a GitHub Notifications + PR-diff page) and when is answered with two concrete trigger conditions ("when GitHub is the user's only connected connector, or when the user explicitly scopes their daily digest to GitHub"), plus an explicit negative trigger ("should not be triggered manually"). This is equivalent explicit trigger guidance to a 'Use when...' clause, so the cap at 3 does not apply; it is more explicit than the anchor-4 example.

5 / 5

Trigger Term Quality

Good natural-term coverage — "GitHub", "daily digest", "briefing", "PRs" are phrases a user would say — but common synonyms are missing (e.g. "pull requests" spelled out, "notifications", "review requests" appears only as a data type). Fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche: an Orbit pipeline GitHub briefing with conditions that exclude every other connector scope. The dual invocation conditions plus the explicit 'not triggered manually' note make accidental triggering by a generic GitHub or digest skill unlikely — matches the minimal-conflict anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

design-templates/orbit-github/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.