CtrlK
BlogDocsLog inGet started
Tessl Logo

subsystem-summary-of-rust

read this skill for a token-efficient summary of the rust subsystem

56

Quality

63%

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 ./.claude/skills/subsystem-summary-of-rust/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 token-dense subsystem summary: concrete file-level and function-level facts, clear data-flow walkthroughs, and no filler or generic-concept padding. The only structural question is that everything lives in one file, which is arguably appropriate for a summary skill but leaves no progressive-disclosure layer.

DimensionReasoningScore

Conciseness

Every line carries subsystem-specific facts (file roles, exact crate versions, full function signatures, dispatch rules, build gotchas); there is no padding and no explanation of concepts Claude already knows (it never explains what FFI or base64 is in general). This matches the 'lean and efficient; every token earns its place' anchor — the exhaustive signature lists are dense reference data, not fluff.

5 / 5

Actionability

The body is highly concrete: exact file paths in the layout table, full parameter lists and return types for every exported function, precise dispatch semantics ('each entry's implied minimum protocol is one more than the previous entry's max_proto'), and step-numbered data flows. It is not a 5 because as a summary document it describes rather than instructs — there are no runnable commands or examples — though per the scoring notes this is only a minor gap for a knowledge/reference skill.

4 / 5

Workflow Clarity

The three 'Key Data Flows' sections (C++ → soroban invocation → C++, logging, module-cache lifecycle) present clearly numbered, coherent sequences, and the multi-protocol dispatch logic is spelled out step by step. No validation checkpoints appear, but the skill is documentation rather than an operational workflow, so the feedback-loop requirement doesn't apply; it is not a 5 only because there are no checkpoints/error-recovery paths to speak of.

4 / 5

Progressive Disclosure

The single file is cleanly organized with headers, tables, and a consistent section hierarchy, and there are no buried or nested references (no bundle files exist, and nothing is cited that isn't present). It is not a 5 because ~245 lines of exhaustive API detail (full signature lists, dependencies table, build notes) exceeds a lean overview and could be split into reference files; it is not a 3 because nothing that belongs elsewhere is missing and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

45%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 names its domain and purpose but is minimal: a single generic action, no trigger guidance, and sparse keywords. It is serviceable but would benefit from naming the subsystem's core capabilities and an explicit 'Use when...' clause.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about the Rust subsystem, the cxx FFI bridge, soroban host dispatch, or Rust-side fees in stellar-core' — this would lift both completeness and trigger term quality.

Name 1-2 concrete capabilities instead of the generic 'summary' (e.g., 'Summarizes the stellar-core Rust static library: the cxx FFI bridge, protocol-versioned soroban host dispatch, module caching, and fee computation') to raise specificity.

Include natural synonyms users would say ("rust code", "FFI", "soroban host", "RustBridge") to widen trigger coverage and reduce overlap with generic Rust skills.

DimensionReasoningScore

Specificity

The description names the domain ("the rust subsystem") but offers only one generic action ("a token-efficient summary"), matching 'Processes PDF files' — domain named, actions minimal. It is not a 3 because it lists no concrete capability (e.g., FFI bridge, host dispatch, fee computation), and not a 1 because the domain and deliverable are named.

2 / 5

Completeness

It has a reasonably clear 'what' ("a token-efficient summary of the rust subsystem") but no 'when' — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

It contains some relevant natural keywords ("rust", "subsystem", "summary") but misses common variations and synonyms a user might say, such as "Rust code", "cxx bridge", "soroban host", or "stellar-core Rust". It is not a 4 because keyword coverage is thin — only 'rust subsystem' would reliably match a user query.

3 / 5

Distinctiveness Conflict Risk

"the rust subsystem" is fairly distinct within this codebase, but the bare word "rust" plus the generic "summary" could overlap with general Rust-development or code-summmary skills. It is not a 4 because no qualifiers (e.g., "FFI bridge", "soroban") narrow the niche, and not a 2 because the subsystem scoping provides some distinction.

3 / 5

Total

11

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
stellar/stellar-core
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.