Content
22%Scale 1-5Reviews 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 topic description masquerading as actionable guidance. It identifies a valid domain (Lightning Network protocol review) but provides no concrete methodology, evaluation frameworks, comparison criteria, or worked examples. The 'Instructions' section is entirely generic boilerplate that could apply to any analytical task.
Suggestions
Add a concrete evaluation framework with specific criteria (e.g., a comparison table template covering trust model, on-chain footprint, consensus requirements, liveness, watchtower support) that Claude should fill out when reviewing a protocol.
Provide at least one worked example showing how to analyze a specific channel factory design against the evaluation criteria, with specific questions to ask and tradeoffs to identify.
Replace the generic 'Instructions' bullets with a specific workflow: e.g., 1) Identify the construction's building blocks, 2) Map trust assumptions, 3) Calculate on-chain costs for cooperative/unilateral cases, 4) Assess liveness requirements, 5) Check HTLC/PTLC routing compatibility.
Add concrete comparison anchors (e.g., how SuperScalar compares to Ark, eltoo-based factories, or basic Poon-Dryja) so Claude has reference points for evaluating new proposals.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill has some unnecessary sections like 'Purpose' which repeats the description, and 'Key Topics' which is just a list of keywords that don't add actionable value. The 'Instructions' section is extremely generic. However, it's not excessively verbose overall. | 3 / 5 |
Actionability | The skill provides no concrete guidance on how to actually review protocols, compare channel factories, or analyze tradeoffs. The 'Instructions' section is entirely generic ('Clarify goals, constraints, and required inputs. Apply relevant best practices.') with no specific frameworks, evaluation criteria, comparison matrices, or worked examples. | 1 / 5 |
Workflow Clarity | There is no meaningful workflow defined. The three bullet points in 'Instructions' are so generic they could apply to any task. There's no sequence for how to conduct a protocol review, no validation checkpoints, and no structured comparison methodology. | 1 / 5 |
Progressive Disclosure | The skill has some structure with sections (Use when, Instructions, Purpose, Key Topics, References) and provides external links. However, there are no bundle files to support deeper content, and the references section is just links without context on what each contains or when to use them. | 3 / 5 |
Total | 8 / 20 Passed |