CtrlK
BlogDocsLog inGet started
Tessl Logo

lightning-factory-explainer

Explain Bitcoin Lightning channel factories and the SuperScalar protocol — scalable Lightning onboarding using shared UTXOs, Decker-Wattenhofer trees, timeout-signature trees, MuSig2, and Taproot. No soft fork required.

43

Quality

44%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/lightning-factory-explainer/SKILL.md

The canonical home for this skill is lightning-factory-explainer in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

18%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is essentially a placeholder that lists topics and links without providing any actual instructional content. It contains no concrete explanations of the SuperScalar protocol, no architectural diagrams or descriptions, no code examples, and no actionable guidance. The generic 'Instructions' bullets ('Clarify goals, constraints, and required inputs') are filler that could apply to any skill and teach Claude nothing it doesn't already know.

Suggestions

Replace the generic 'Instructions' bullets with actual content explaining the SuperScalar protocol architecture — e.g., how Decker-Wattenhofer trees work, how timeout-signature trees layer on top, and how Poon-Dryja channels fit in.

Add concrete examples or diagrams showing the tree structure of a channel factory with N users sharing a single UTXO, including the role of MuSig2 and Taproot.

Include a workflow or step-by-step explanation of how an LSP onboards users using SuperScalar — from UTXO creation through channel establishment to eventual timeout/exit.

Move the 'Key Topics' list into actual sections with substantive content for each topic, or create bundle files with detailed explanations and reference them clearly from the SKILL.md overview.

DimensionReasoningScore

Conciseness

The skill has some unnecessary sections like the generic 'Instructions' bullet points ('Clarify goals, constraints, and required inputs') that add no value. The 'Purpose' section largely restates the description and other content. However, it's not excessively verbose — it's moderately padded with redundant information.

3 / 5

Actionability

The skill provides no concrete, executable guidance whatsoever. The 'Instructions' section contains only generic platitudes ('Apply relevant best practices and validate outcomes'). There are no code examples, no specific commands, no protocol details, no architectural explanations — just links to external resources and a list of topic names.

1 / 5

Workflow Clarity

There is no workflow, no sequenced steps, and no process described. The 'Instructions' section has three vague bullets that could apply to literally any task. For a skill about understanding a complex protocol architecture, there should be at least a structured explanation flow or analysis steps.

1 / 5

Progressive Disclosure

The skill references external URLs but has no bundle files to support progressive disclosure. The content that should be the core of the skill (actual protocol explanations, architectural details, examples) is entirely absent — it's just deferred to external GitHub links with no inline substance to serve as an overview.

2 / 5

Total

7

/

20

Passed

Description

70%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 highly specific to a niche Bitcoin/Lightning topic, making it very distinctive and unlikely to conflict with other skills. It lists concrete technical concepts well but reads more as a topic summary than an actionable skill description, and it lacks an explicit 'Use when...' clause that would help Claude know when to select it.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Lightning scalability, channel factories, SuperScalar, or trustless onboarding mechanisms.'

Include broader trigger synonyms like 'Bitcoin scaling', 'Layer 2', 'payment channels', or 'off-chain transactions' to capture users who may not use the exact technical terms.

DimensionReasoningScore

Specificity

Lists several specific technical concepts (channel factories, SuperScalar protocol, Decker-Wattenhofer trees, timeout-signature trees, MuSig2, Taproot) and names the domain clearly. However, the actions are more about explaining concepts than performing concrete tasks — it's essentially 'explain X' with a detailed list of X.

4 / 5

Completeness

The 'what' is clear — explain Bitcoin Lightning channel factories and the SuperScalar protocol. However, there is no explicit 'when' clause (no 'Use when...' or equivalent trigger guidance), which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

Includes highly specific and natural keywords a user interested in this topic would use: 'Lightning', 'channel factories', 'SuperScalar', 'MuSig2', 'Taproot', 'shared UTXOs', 'onboarding'. Missing some broader synonyms like 'Bitcoin scaling', 'L2', or 'payment channels' that users might also say.

4 / 5

Distinctiveness Conflict Risk

This is an extremely niche topic — SuperScalar protocol, Decker-Wattenhofer trees, and channel factories are highly specific concepts unlikely to overlap with any other skill. The combination of these terms creates a very clear and distinct niche.

5 / 5

Total

16

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.