ReddRadar
Agent skill
check-lightning
Audit Lightning Network integration. Checks node health, channel balances, peer connectivity, invoice handling, and routing. Use when: reviewing Lightning setup, diagnosing payment failures, or capacity planning. Keywords: lightning, lnd, cln, channels, invoices, bolt11.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/check-lightning
SKILL.md
/check-lightning
Audit Lightning integration. Output findings as structured report.
What This Does
- Check node sync status
- Check channel balances (inbound/outbound)
- Audit peer connectivity
- Verify invoice generation
- Review payment routing success rate
- Check watchtower configuration
- Output prioritized findings (P0-P3)
This is a primitive. It only investigates and reports. Use /log-lightning-issues to create GitHub issues or /fix-lightning to fix.
Process
1. Node Sync Status (lncli getinfo)
bash
# LND: node info + sync status
lncli --network=testnet getinfo
# CLN alternative
lightning-cli getinfo
2. Channel Balance (inbound/outbound liquidity)
bash
# Channel balances + local/remote liquidity
lncli --network=testnet channelbalance
lncli --network=testnet listchannels
# On-chain wallet balance
lncli --network=testnet walletbalance
# CLN alternative
lightning-cli listfunds
lightning-cli listchannels
3. Peer Connectivity
bash
# Peers connected?
lncli --network=testnet listpeers
# CLN alternative
lightning-cli listpeers
4. Invoice Generation
bash
# Create test invoice (bolt11)
lncli --network=testnet addinvoice --amt 1000 --memo "healthcheck"
# List invoices
lncli --network=testnet listinvoices --max_invoices 5
# CLN alternative
lightning-cli invoice 1000 "healthcheck" "healthcheck"
lightning-cli listinvoices
5. Payment Routing Success Rate
bash
# Forwarding history (route success)
lncli --network=testnet fwdinghistory --max_events 50
# Recent payments
lncli --network=testnet listpayments --max_payments 20
# CLN alternative
lightning-cli listforwards
lightning-cli listpays
6. Watchtower Configuration
bash
# Watchtower info (LND)
lncli --network=testnet tower info 2>/dev/null || echo "No tower info (watchtower off?)"
lncli --network=testnet listtowers 2>/dev/null | head -5
# CLN alternative
lightning-cli listwatchtowers 2>/dev/null | head -5
7. Deep Audit
Spawn lightning-auditor agent for comprehensive review:
- Channel policy sanity (fees, cltv deltas)
- Route liquidity vs payment sizes
- Invoice expiry + preimage handling
- Peer reliability and channel age
- Backup + recovery posture
Output Format
markdown
## Lightning Audit
### P0: Critical (Payment Failures)
- Node not synced - Cannot route or pay
- No inbound liquidity - Invoices cannot be paid
- Watchtower disabled on public node
### P1: Essential (Must Fix)
- Peers disconnected or flapping
- High failure rate in forwarding history
- Invoice generation failing (bolt11 invalid)
### P2: Important (Should Fix)
- Low outbound liquidity - Payments often fail
- Fee policy too high for routes
- No channel backups verified
- No monitoring for stuck HTLCs
### P3: Nice to Have
- Optimize channel mix for inbound capacity
- Add more diverse peers
- Track success rate over time
## Current Status
- Sync: Unknown
- Liquidity: Unknown
- Peers: Unknown
- Invoices: Unknown
- Routing: Unknown
- Watchtower: Unknown
## Summary
- P0: 2 | P1: 3 | P2: 4 | P3: 3
- Recommendation: Fix sync + inbound liquidity before routing work
Priority Mapping
| Gap | Priority |
|---|---|
| Node not synced | P0 |
| No inbound liquidity | P0 |
| Watchtower off on public node | P0 |
| Peer instability | P1 |
| Routing failures | P1 |
| Invoice generation broken | P1 |
| Low outbound liquidity | P2 |
| Fee policy too high | P2 |
| Missing channel backups | P2 |
| Optimization work | P3 |
Related
/log-lightning-issues- Create GitHub issues from findings/fix-lightning- Fix Lightning issues/lightning- Full Lightning lifecycle management/check-bitcoin- Bitcoin on-chain audit/check-btcpay- BTCPay Server audit/check-payments- Multi-provider payment audit
Didn't find tool you were looking for?