CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lightning-architecture-review

Review Bitcoin Lightning Network protocol designs, compare channel factory approaches, and analyze Layer 2 scaling tradeoffs. Covers trust models, on-chain footprint, consensus requirements, HTLC/PTLC compatibility, liveness, and watchtower support.

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 ./skills/lightning-architecture-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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 well-organized as an overview but delivers almost no substantive guidance: the instructions are generic filler, the actual review methodology is entirely absent, and the same topic list is repeated across three sections. What remains is essentially a description plus links to the SuperScalar project rather than an expert review procedure.

Suggestions

Replace the generic 'Instructions' bullets with a concrete review methodology: e.g., enumerate the questions to answer per design (who can steal funds and when? what on-chain footprint per client at open/exit? which consensus changes are required? are HTLCs/PTLCs routable end-to-end? what happens on liveness failure?), with worked comparisons against Poon-Dryja, Decker-Wattenhofer, and factory baselines.

Deduplicate the 'Purpose' and 'Key Topics' sections, which restate the frontmatter description nearly verbatim — keep one overview and spend the saved tokens on the actual review criteria.

Add concrete evaluation artifacts: a comparison table template (trust model / on-chain footprint / exit complexity / watchtower support), commands for reproducing cost calculations, or bundled reference files for each factory approach instead of a single promotional link.

DimensionReasoningScore

Conciseness

The body restates the frontmatter description three times: the 'Use this skill when' bullets, the 'Purpose' section ('Expert reviewer for... Compares channel factory approaches...'), and the 'Key Topics' list all enumerate the same topics. The 'Instructions' bullets are generic platitudes ('Apply relevant best practices and validate outcomes'), the SuperScalar paragraph reads as promotional copy, and the GitHub URL is repeated in both 'Instructions' and 'References'. This matches the anchor for noticeably verbose with several unnecessary or padded sections — above score 1 only because the body is short overall.

2 / 5

Actionability

There is no concrete review methodology, checklist, evaluation criteria, comparison framework, or executable example — the actual instructions reduce to vague direction like 'Apply relevant best practices and validate outcomes.' The only concrete content is reference pointers (real URLs) and a one-line description of SuperScalar's mechanisms, which is minimal concrete guidance missing the specific steps, matching the score-2 anchor rather than score 1's entirely-vacuous example (something concrete is present) and far from score 3's incomplete-but-real guidance.

2 / 5

Workflow Clarity

The 'Instructions' section offers only a rough, poorly defined pseudo-sequence ('Clarify goals... Apply relevant best practices... Provide actionable steps and verification') with no checkpoints, no validation steps, and no error-recovery guidance. This matches the anchor for a rough sequence with many gaps and absent validation; it is above score 1 because a vague three-step order does exist, and below score 3, which requires at least a real, step-level sequence.

2 / 5

Progressive Disclosure

The body is under 50 lines, needs no external bundle files (none exist), and is organized into clear, well-labeled sections ('Use this skill when', 'Do not use this skill when', 'Instructions', 'Purpose', 'Key Topics', 'References') with one-level-deep external references. Per the simple-skill guidance, well-organized sections suffice for a score of 5; the redundancy across sections is a token-efficiency issue scored under conciseness, not a navigation problem.

5 / 5

Total

11

/

20

Passed

Description

75%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, highly specific description with a clearly defined niche and good natural keyword coverage. Its only real deficiency is the absence of an explicit 'Use when...' trigger clause, which caps completeness and leaves triggering to be inferred from topic coverage alone.

Suggestions

Add an explicit trigger clause, e.g., 'Use when reviewing Lightning protocol proposals, comparing channel factory designs (e.g., SuperScalar, Duplex channels), or evaluating Layer 2 scaling tradeoffs.'

Include a few more natural synonym phrases users would say, such as 'payment channels', 'Lightning', or 'HTLCs', to widen trigger coverage.

DimensionReasoningScore

Specificity

Multiple concrete actions are named ('Review Bitcoin Lightning Network protocol designs, compare channel factory approaches, and analyze Layer 2 scaling tradeoffs') plus an explicit coverage list ('trust models, on-chain footprint, consensus requirements, HTLC/PTLC compatibility, liveness, and watchtower support'). This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor which implies minor gaps.

5 / 5

Completeness

The 'what' is clearly and specifically stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. It sits above the score-2 anchor (which requires a vague 'what') because the 'what' here is concrete, and below score 4, which requires an explicit 'when'.

3 / 5

Trigger Term Quality

Natural domain phrases users would say are present ('Lightning Network', 'channel factory', 'Layer 2 scaling', 'trust models', 'watchtower'), giving good keyword coverage. A few common variations are missing (e.g., 'payment channels', 'Lightning' alone, 'HTLCs'), so it is not the comprehensive-with-synonyms level of the score-5 anchor, but it is clearly above the score-3 anchor's missing-variations example.

4 / 5

Distinctiveness Conflict Risk

The description stakes out a clear niche (Bitcoin Lightning Network protocol design review, channel factories, Layer 2 scaling tradeoffs) with distinct, domain-specific triggers, giving minimal conflict risk with other skills. This matches the score-5 anchor exactly and is well above the score-4 'minor overlap 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/lightning-architecture-review/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.