Agent skill
debug
Add traceable debug logs that can be auto-removed with a single command. Use when debugging issues - logs follow a strict format for clean removal.
Install this agent skill to your Project
npx add-skill https://github.com/perfux/perfux-opencode-plugin/tree/main/src/skill/debug
SKILL.md
Debug Logging
Add debug logs in this exact format so they can be auto-removed:
Format
// [DEBUG:PERFUX] <description>
console.log("[DEBUG:PERFUX]", <values>);
Examples
JavaScript/TypeScript:
// [DEBUG:PERFUX] Check user state
console.log("[DEBUG:PERFUX]", { user, isLoggedIn });
Python:
# [DEBUG:PERFUX] Check user state
print("[DEBUG:PERFUX]", user, is_logged_in)
Process
- Identify the issue area
- Add debug logs at key points (entry, exit, state changes)
- Run the code and analyze output
- Iterate: add more logs if needed
- When done, run the removal script
Removal
Run from project root:
.opencode/skill/debug/scripts/remove-debug-logs.ts
Or with bun:
bun .opencode/skill/debug/scripts/remove-debug-logs.ts
All lines containing [DEBUG:PERFUX] are removed automatically.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
debug
Add traceable debug logs that can be auto-removed with a single command. Use when debugging issues - logs follow a strict format for clean removal.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
Didn't find tool you were looking for?