rcarmo/extension-troubleshoot
skel/.pi/skills/extension-troubleshoot/SKILL.md
Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.
$ install --global
skillsauthnpx skillsauth add rcarmo/piclaw extension-troubleshootInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 11, 2026, 8:34 PM22.4s1 file scanned
SKILL.md
- name:
- extension-troubleshoot
- description:
- Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.
- distribution:
- public
Extension Troubleshoot (piclaw)
Use this when piclaw web chats only show thinking or extensions throw errors.
Steps
- Check extension errors
tail -n 80 /var/log/piclaw/piclaw.stderr.log
- Inspect current extension file(s)
readlink -f /workspace/.pi/extensions/context-mode.ts
sed -n '1,120p' /workspace/.pi/extensions/context-mode.ts
- Ensure imports reference installed piclaw (not workspace src)
- Use installed path: /home/agent/.bun/install/global/node_modules/piclaw/dist/...
- Avoid /workspace/piclaw or node_modules symlinked to workspace.
- Harden extension
- Remove/avoid startup cleanup that touches DB before init.
- Wrap tool executes with try/catch to prevent crashes.
- Guard saveToolOutput with try/catch.
- Update skel extension too
cp /workspace/.pi/extensions/context-mode.ts /workspace/piclaw/skel/.pi/extensions/context-mode.ts
- Fix workspace watcher permissions (if fs.watch warns on tailscale)
sudo chown -R agent:agent /workspace/.piclaw/tailscale
- Restart piclaw
supervisorctl restart piclaw
- Verify
tail -n 40 /var/log/piclaw/piclaw.stderr.log
Related Skills
rcarmo/m365-document-link-metadata
documentation
VerifiedTrustedCommunity
Resolve Teams or SharePoint document links to canonical metadata.
511SKILL.mdUpdated Apr 15, 2026
rcarmo/web-search
development
VerifiedTrustedCommunity
Search the web via SearXNG and optionally convert result pages to Markdown.
468SKILL.mdUpdated Apr 11, 2026
rcarmo/web-search-summary
development
VerifiedTrustedCommunity
Search via SearXNG, fetch top results, and return quick summaries plus markdown.
468SKILL.mdUpdated Apr 11, 2026
rcarmo/twitter-summary
testing
VerifiedTrustedCommunity
Fetch a user's recent tweets (tweets, replies, retweets) using Playwright + Nitter fallbacks and produce compact JSON/Markdown summaries.
468SKILL.mdUpdated Apr 11, 2026