Execute qualquer Skill no Manus
com um clique

Execute qualquer Skill no Manus com um clique

Começar

extension-troubleshoot

Estrelas799

Forks74

Atualizado17 de julho de 2026 às 09:38

Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Executar no Manus

Fonte

rcarmo

rcarmo/piclaw

Abrir repositório GitHub Ver repositórios do creator

Download

Executar no Manus

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Administradores de redes e sistemas de computadorInformática e Matemática·SOC 15-1244

SKILL.md

readonly

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

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 the current extension file:

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 source.
- In the container layout, use packaged sources under /usr/local/lib/bun/install/global/node_modules/piclaw/runtime/....
- Avoid imports from /workspace/piclaw or workspace-local node_modules; those paths can drift after reloads.
Harden the extension.
- Remove startup cleanup that touches the DB before init.
- Wrap tool executes in try/catch.
- Guard saveToolOutput with try/catch.

Update the matching skel extension:

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 only with explicit user permission.

For an agent-driven restart, run session_status first. If another session is active, report it and wait. Otherwise send the final response, then call exit_process as the last tool action.

For a manual shell restart, identify the host's active service manager and use it directly:
```
# Supervisor-managed container
supervisorctl restart piclaw

# systemd user unit, including LXC or host-native installs
systemctl --user restart piclaw.service
```

Verify:

tail -n 40 /var/log/piclaw/piclaw.stderr.log

Mais deste repositório

mesmo repositório

kanban-management

rcarmo/piclaw

ARCHIVED — project work items are tracked in GitHub Issues and GitHub Projects. Use the github-issues skill when installed, or use gh directly.

2026-07-17799

web-search

rcarmo/piclaw

Search the web via SearXNG (or DuckDuckGo fallback) and optionally fetch result pages as raw Markdown content.

2026-07-17799

web-search-summary

rcarmo/piclaw

Search via SearXNG (or DuckDuckGo fallback), fetch top results, and return sentence-level summaries plus optional converted page content.

2026-07-17799

twitter-summary

rcarmo/piclaw

Fetch a user's recent tweets (tweets, replies, retweets) using Playwright + Nitter fallbacks and produce compact JSON/Markdown summaries.

2026-07-17799

technical-docs

rcarmo/piclaw

Write and review concise technical documentation using a plain-English voice guide and anti-trope filter. Use for READMEs, design notes, runbooks, API documentation, release notes, and pull-request text.

2026-07-17799

situate-daily-notes

rcarmo/piclaw

Situate yourself by generating a 1-page situation report and maintaining Obsidian-style daily summary notes.

2026-07-17799

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

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 the current extension file:

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 source.
- In the container layout, use packaged sources under /usr/local/lib/bun/install/global/node_modules/piclaw/runtime/....
- Avoid imports from /workspace/piclaw or workspace-local node_modules; those paths can drift after reloads.
Harden the extension.
- Remove startup cleanup that touches the DB before init.
- Wrap tool executes in try/catch.
- Guard saveToolOutput with try/catch.

Update the matching skel extension:

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 only with explicit user permission.

For an agent-driven restart, run session_status first. If another session is active, report it and wait. Otherwise send the final response, then call exit_process as the last tool action.

For a manual shell restart, identify the host's active service manager and use it directly:
```
# Supervisor-managed container
supervisorctl restart piclaw

# systemd user unit, including LXC or host-native installs
systemctl --user restart piclaw.service
```

Verify:

tail -n 40 /var/log/piclaw/piclaw.stderr.log