Debug Package Usage Guide
SkillFiles & storageGuides your agent in adding debug() logging and choosing lobe-* namespaces for troubleshooting output.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Debug Package Usage Guide skill
About this capability
LobeHub debug package and log namespace guide. Use when adding debug() logging, choosing lobe-* namespaces, troubleshooting DEBUG output, localStorage.debug, or log format specifiers.
What this skill tells your AI
The instructions your AI receives, as published by lobehub/lobehub in .agents/skills/debug-package/SKILL.md and read by ahel’s review.
Basic Usage
import debug from 'debug';
// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');
log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);
Namespace Conventions
- Desktop:
lobe-desktop:[module] - Server:
lobe-server:[module] - Client:
lobe-client:[module] - Router:
lobe-[type]-router:[module]
Format Specifiers
%O- Object expanded (recommended for complex objects)%o- Object%s- String%d- Number
Enable Debug Output
Browser
localStorage.debug = 'lobe-*';
Node.js
DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';
Example
// apps/server/src/routers/edge/market/index.ts
import debug from 'debug';
const log = debug('lobe-edge-router:market');
log('getAgent input: %O', input);
Signals
- GitHub stars
- 82k
- Forks
- 16k
- Last commit
- Sep 2026
ahel recommends instead
Advanced
- Catalog kind
- skill
- Gateway key
debug-package-lobehub- Source
- github.com/lobehub/lobehub