CtrlK
BlogDocsLog inGet started
Tessl Logo

subsystem-summary-of-protocol-curr

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

55

Quality

61%

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-protocol-curr/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 exceptionally dense, well-organized reference that delivers on its token-efficiency promise: every section maps project-specific types Claude could not otherwise know. Its main weaknesses are the absence of an explicit 'consult the .x source for full definitions' pointer and no regen/verification commands, which keep actionability and workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is a dense catalog of project-specific types (e.g. 'SCValType enum (22 variants)', 'OperationType enum (27 operations)') — exactly the information Claude cannot know generically — with essentially no filler. The only marginal padding is the expanded acronym 'XDR (External Data Representation)' and one sentence of context about git submodule status, which is genuinely useful project-specific fact. Fits the anchor 'lean and efficient; assumes Claude's competence; every token earns its place'; not a 4 because there is no over-explanation of concepts Claude already knows.

5 / 5

Actionability

For a reference/lookup skill, the guidance is concrete: an explicit dependency DAG showing which file each module lives in, plus the actionable instruction 'Never edit .h files directly; always modify the .x source files.' Fits anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps'). Not a 5 because there are no commands for regenerating headers or verifying changes, and it never explicitly tells the reader to consult the actual .x file for full definitions; not a 3 because the file-level pointers are specific and immediately usable.

4 / 5

Workflow Clarity

This is a single-purpose lookup skill with no risky or multi-step operation, so no validation checkpoints are required; navigation is unambiguous via the dependency graph and per-module sections. Fits anchor 4 ('clear sequence with most checkpoints present; minor gaps') in the sense that the consultation flow (locate module → read summary) is clear, but the implied next step (open the .x file for authoritative detail) is never stated. Not a 5 because that final pointer is missing; not a 3 because nothing is ambiguous or fragile.

4 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist and the skill references none, so there are no buried or nested references to penalize; all content lives in SKILL.md, which is appropriate for a skill whose stated purpose is a self-contained token-efficient summary. Section headers, a dependency tree, and per-module subsections make navigation easy. Fits anchor 4 ('good structure; most content is appropriately placed; minor organization gaps') — the 230-line catalog could arguably be split per module, though the summary-first design justifies inlining. Not a 5 because the size exceeds the 'under 50 lines, no external references needed' bar and a per-module split would allow finer-grained loading.

4 / 5

Total

17

/

20

Passed

Description

41%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 identifies a specific niche but is thin: it states a single generic action and completely omits when to use the skill. Adding an explicit trigger clause and naming the actual subject matter (XDR/Stellar type definitions) would materially improve it.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when exploring, editing, or tracing types in src/protocol-curr/xdr/'.

Name the subject matter concretely instead of only the subsystem label: 'summarizes the XDR (.x) type definitions for Stellar's current protocol'.

Include natural trigger terms users would type, such as 'XDR', '.x files', 'ledger entries', 'transaction types', and 'Stellar type definitions'.

DimensionReasoningScore

Specificity

The description names the domain ("protocol-curr subsystem") but offers only one generic action ("token-efficient summary"). It matches the anchor 'Names the domain but actions are minimal or generic' — it never says what the subsystem contains (XDR type definitions, .x files) or what concrete capabilities the skill provides. Not a 1 because 'protocol-curr' is a concrete, real domain rather than pure abstraction; not a 3 because it does not list even 1-2 concrete actions like 'summarizes XDR types' or 'maps ledger entry definitions'.

2 / 5

Completeness

A 'what' is present ("token-efficient summary of the protocol-curr subsystem") but there is no 'Use when...' clause or equivalent trigger guidance, so completeness is capped at 3 per the judging guidelines. Fits anchor 3 ('clear what but when is missing'). Not a 4 because the when is entirely absent rather than merely imprecise; not a 2 because the what, while thin, is not vague.

3 / 5

Trigger Term Quality

The only keyword is the internal jargon name "protocol-curr subsystem"; natural user phrases like 'XDR', 'Stellar', 'type definitions', '.x files', or 'ledger entries' are all missing. Fits anchor 2 ('one or two generic keywords; missing the natural phrases users say'). Not a 3 because there are no synonyms or variations present beyond the single subsystem name; not a 1 because the term is relevant and would be said by someone already working in this codebase.

2 / 5

Distinctiveness Conflict Risk

The unique subsystem name ('protocol-curr') carves out a clear niche and would rarely fire for unrelated skills. Fits anchor 4 ('mostly distinct; minor overlap risk with closely related skills') — e.g., sibling skills for adjacent subsystems or a 'protocol-old' variant could compete for the same query. Not a 5 because the description gives no content cues (XDR, Stellar) that would further separate it from other summary skills.

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