CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orbit-general

Open Orbit briefing skill — selected by the Orbit pipeline when the user has two or more connectors connected. Pulls the past 24 hours of activity from every authenticated connector (GitHub, Linear, Notion, Slack, 飞书, Calendar, Gmail, Drive, Sentry, Vercel, …) and renders a single adaptive bento-grid dashboard at the top of "我的设计". Each connector module picks its own UI form (list, avatar stack, status ring, heatmap, file grid, alert card, …) based on the data shape it returns, so the layout scales as Orbit's connector ecosystem grows. This skill should not be triggered manually — it is invoked by Orbit's daily-digest scheduler against the user's live connector data.

58

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./design-templates/orbit-general/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 richly detailed, well-sectioned design spec with a clear reproduction-first workflow, but its two structural weaknesses pull it down: the canonical example.html the entire protocol depends on is missing from the bundle, and significant content (the connector mapping table, the do/don't restatement of it) is inlined and duplicated where a single reference file would serve. Adding a closing validation checkpoint would complete the workflow.

Suggestions

Ship the referenced example.html (or inline the structural skeleton it defines) — Step 1 of the protocol is currently impossible to execute, which caps both actionability and progressive disclosure.

Merge the "Implementation constraints" do/don't table into the connector→UI mapping (it largely restates it) and move the 15-family mapping plus fallback heuristics into a references/ file linked one level deep from SKILL.md.

Add an explicit final verification step to the protocol, e.g. 'Step 4: Before delivering, diff your output against example.html section-by-section — section count, module order, connector list, and footer string must match exactly.'

DimensionReasoningScore

Conciseness

The body is information-dense (exact hex tokens, pixel sizes, fonts, section order), but there is real redundancy: the "Implementation constraints" do/don't table restates the connector→UI mapping table nearly verbatim (e.g. Sentry's "big red number + 7-day heatmap" appears twice), and the design-system policy is asserted three times ("⚠️ Design system policy", the bullet list, and "This is a hard constraint"). It could be tightened without losing any guidance — the anchor-3 fit — while it clearly exceeds anchor 2's padded explanatory style.

3 / 5

Actionability

The spec level is very concrete (exact tokens, Cormorant/Inter stacks, section heights, per-family UI forms, fallback heuristics), but the protocol's Step 1 — "Open and read the shipped `example.html` in this folder … your job is to reproduce it" — is non-executable because example.html is not present in the bundle (no references/, scripts/, or assets/ directories exist). The central instruction hinges on a missing key artifact, which is the anchor-3 'missing key details' fit rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

The "Source-of-truth protocol" gives a clear numbered 3-step sequence (read example → mirror 1:1 with an explicit checklist of what must match → freshen data values only) followed by identity-guard and hard-constraint rules — a coherent, well-sequenced workflow. It falls short of anchor 5 because there is no final validation/check step (e.g. 'compare your output section-by-section against example.html before delivering'), leaving a minor checkpoint gap.

4 / 5

Progressive Disclosure

Sections are well organized and the one external reference (example.html) is clearly signaled and prominent. However, scored against the actual bundle structure, that referenced path does not exist, and a large operational table (the 15-family connector→UI mapping) that would sit naturally in a reference file is fully inlined in a ~200-line single file. That is anchor 3's 'content that should be separate is inline / references present but not resolvable' rather than anchor 4's 'minor organization gaps'.

3 / 5

Total

13

/

20

Passed

Description

80%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, specific, third-person description that clearly delimits what the skill does and how it is (and is not) invoked, with excellent distinctiveness. Its weakest point is trigger-term coverage: several natural phrases users might say (morning briefing, daily summary, Chinese variants) appear only in the frontmatter triggers, not the description text.

Suggestions

Fold one or two natural user-facing trigger phrases (e.g. "morning briefing", "daily digest", "跨工具汇总") into the description prose so keyword coverage doesn't depend solely on the triggers list.

Briefly enumerate one or two more rendered artifacts (KPI strip, timeline, Top 3 priorities) to move capability coverage from 'several actions' to comprehensive.

DimensionReasoningScore

Specificity

Concrete third-person actions are named — "Pulls the past 24 hours of activity from every authenticated connector" and "renders a single adaptive bento-grid dashboard" — plus named connectors (GitHub, Linear, Notion, Slack, 飞书, Calendar, …). It stops short of anchor 5 because it omits several capabilities the skill actually performs (KPI strip, timeline, Top 3, connector-to-UI fallback mapping), and is comfortably above anchor 3 since more than 1–2 concrete actions are listed.

4 / 5

Completeness

The description explicitly answers both questions: what ("Pulls the past 24 hours of activity from every authenticated connector … renders a single adaptive bento-grid dashboard") and when ("selected by the Orbit pipeline when the user has two or more connectors connected", "invoked by Orbit's daily-digest scheduler … should not be triggered manually"). This is equivalent explicit trigger guidance, so the 'Use when…' cap at 3 does not apply, and the when is concrete rather than the merely-explicit-but-imprecise anchor 4.

5 / 5

Trigger Term Quality

Relevant keywords appear ("briefing", "daily-digest", "Open Orbit", "connector", "dashboard"), but common natural variations a user would say — "morning briefing", "summary", "汇总/简报" in the description itself — are missing (they exist only in the separate triggers list). Not a 4: coverage is partial rather than good-with-a-few-missing; not a 2 because the terms present are domain-relevant and natural, not generic.

3 / 5

Distinctiveness Conflict Risk

A clear niche — an Orbit-internal, scheduler-invoked, multi-connector briefing rendered in "我的设计" — with named connectors and an explicit statement that it is never triggered manually. Virtually no other skill would match these conditions, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

17

/

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-general/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.