diff options
Diffstat (limited to 'skills')
| -rw-r--r-- | skills/agent-orchestration.md | 35 | ||||
| -rw-r--r-- | skills/bug-tracker.md | 30 | ||||
| -rw-r--r-- | skills/debug-panel-and-logs.md | 34 | ||||
| -rw-r--r-- | skills/index.json | 249 | ||||
| -rw-r--r-- | skills/security-and-safety.md | 37 | ||||
| -rw-r--r-- | skills/task-manager.md | 37 | ||||
| -rw-r--r-- | skills/webdav-operations.md | 33 |
7 files changed, 454 insertions, 1 deletions
diff --git a/skills/agent-orchestration.md b/skills/agent-orchestration.md new file mode 100644 index 0000000..060ec96 --- /dev/null +++ b/skills/agent-orchestration.md @@ -0,0 +1,35 @@ +--- +name: agent-orchestration +description: How to use the agent registry, leases, and orchestrator for multi-agent workflows +tags: [agents, orchestration, delegation, leases] +category: system +--- +## Steps +1. **Agent Registry:** + - agent-list — list all registered agents (ID, type, capabilities, status) + - agent-register <type> <capabilities> — register a new agent (capabilities: comma-separated like "code,research") + - agent-unregister <id> — remove an agent + - agent-status <id> — detailed status including uptime, task history + +2. **Leases (time-bound contracts):** + - lease-create <agent-id> <ttl-seconds> — create a lease with watchdog timer + - lease-list — show active leases with remaining TTL + - lease-revoke <lease-id> — terminate a lease early + - lease-renew <lease-id> <ttl-seconds> — extend a lease + +3. **Orchestrator (spawn, delegate, kill):** + - orchestrator-spawn <type> <capabilities> — spawn a new agent automatically (registers + creates lease) + - orchestrator-kill <agent-id> — kill an agent (revokes lease + unregisters) + - orchestrate — list all active agents with their orchestrator state + - orchestrator-purge — kill all idle/expired agents + - orchestrator-status — full system status: active, idle, dead agents + +4. **AI tool integration:** + - AI tools list_agents, delegate_task, spawn_agent are available in the AI system prompt + - The AI can auto-spawn worker agents for sub-tasks + - Each agent gets its own VFS workspace at /agents/<agent-id>/ + +5. **When to use:** + - User needs parallel task execution → orchestrator-spawn coder + researcher + - Time-bound automation → lease-create with short TTL + - System cleanup → orchestrator-purge to kill stale agents
\ No newline at end of file diff --git a/skills/bug-tracker.md b/skills/bug-tracker.md new file mode 100644 index 0000000..05963e4 --- /dev/null +++ b/skills/bug-tracker.md @@ -0,0 +1,30 @@ +--- +name: bug-tracker +description: A systematic approach to tracking and managing bugs in the VFS. +tags: [dev, debugging, management, workflow] +--- + +# Bug Tracking Workflow + +This skill provides a standardized way to track bugs using a JSON-based log file in the root directory. + +## 1. Initialize Bug Log +If `/bugs.json` does not exist, create it with an empty array: `[]`. + +## 2. Reporting a Bug +When a bug is found, append a new entry to `/bugs.json` with the following schema: +- `id`: Unique incremental integer. +- `title`: Brief summary of the issue. +- `description`: Detailed steps to reproduce and expected vs actual behavior. +- `status`: "open" | "in-progress" | "resolved" | "closed". +- `severity`: "low" | "medium" | "high" | "critical". +- `created_at`: Timestamp. +- `updated_at`: Timestamp. + +## 3. Managing Bugs +- **List Open Bugs**: Filter `/bugs.json` for entries where `status != "closed"`. +- **Update Status**: Change the `status` and update the `updated_at` timestamp. +- **Resolve**: Mark as "resolved" and add a `resolution` field explaining the fix. + +## 4. Verification +Once a bug is marked "resolved", run existing tests or manually verify the fix before marking it "closed". diff --git a/skills/debug-panel-and-logs.md b/skills/debug-panel-and-logs.md new file mode 100644 index 0000000..b182e23 --- /dev/null +++ b/skills/debug-panel-and-logs.md @@ -0,0 +1,34 @@ +--- +name: debug-panel-and-logs +description: How to use the debug panel, session logging, and terminal diagnostics +tags: [debug, logging, diagnostics, troubleshooting] +category: system +--- +## Steps +1. **Toggle debug panel:** + - debug — opens real-time debug panel showing last AI tool call, response time, and context + - Debug panel includes Copy, Export, and Write to VFS buttons + - Export: saves tool call log as timestamped JSON to downloads + - Write to VFS: appends debug data to /debug.log (dedup by turn ID) + +2. **Session logging:** + - logs [n] [LEVEL] — view last n log entries (optionally filtered by INFO/WARN/ERROR) + - logrotate — rotate current.log to dated archive (auto-cleans old logs beyond 10) + - Logs stored in /logs/ directory: current.log + dated archives + - Health check runs automatically after complex tasks + +3. **Diagnostic commands:** + - health-check — full audit: VFS size, modules, logs, trash, skills + - check — quick system health including module requirement status + - mem — real-time memory usage (also in header) + - status — network, files, modules, Ollama connectivity + +4. **System journals:** + - debug.log — appended by debug panel VFS button (dedup by turn ID) + - current.log — system activity log with rotation + - Auto-save: terminal state auto-saves every 60s + +5. **When to use:** + - AI is behaving unexpectedly → debug to see tool calls + - User reports errors → logs 50 ERROR to see error entries + - Memory concerns → mem to check, health-check for full audit
\ No newline at end of file diff --git a/skills/index.json b/skills/index.json index 6d57936..a1254ae 100644 --- a/skills/index.json +++ b/skills/index.json @@ -1 +1,248 @@ -{"navigating-the-terminal":{"name":"navigating-the-terminal","description":"How to explore the WebX11 terminal, find commands, check status, and navigate the filesystem","tags":["terminal","navigation","help","filesystem"],"category":"system","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"memory-and-profile":{"name":"memory-and-profile","description":"How to use the user profile system, session memory, and pattern tracking for persistent context","tags":["memory","profile","session","persistence"],"category":"system","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"web-search-and-fetch":{"name":"web-search-and-fetch","description":"How to search the web and fetch URL content using the WebX11 proxy API","tags":["search","fetch","web","proxy","api"],"category":"research","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"module-management":{"name":"module-management","description":"How to view, edit, test, reload modules and manage startup configuration","tags":["modules","editing","code","self-improvement"],"category":"dev","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"system-maintenance":{"name":"system-maintenance","description":"How to reset, troubleshoot, and maintain the WebX11 terminal","tags":["system","maintenance","reset","troubleshoot","config"],"category":"system","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"backup-and-restore":{"name":"backup-and-restore","description":"How to backup, restore, and export WebX11 data","tags":["backup","restore","export","import","persistence"],"category":"system","created":"2026-05-28T15:39:51.676Z","updated":"2026-05-28T15:39:51.676Z"},"mindmap-workflow":{"name":"mindmap-workflow","description":"How to create, view, edit, and manage brainstorming mindmaps","tags":["mindmap","brainstorming","planning","organization"],"category":"productivity","created":"2026-05-28T15:39:51.677Z","updated":"2026-05-28T15:39:51.677Z"},"skills-system-guide":{"name":"skills-system-guide","description":"How to use the skills system: load, create, patch, list, and audit skills for persistent procedural memory","tags":["skills","system","meta"],"category":"system","created":"2026-05-28T15:39:51.677Z","updated":"2026-05-28T15:39:51.677Z"},"mindmap-user-guide":{"name":"mindmap-user-guide","description":"How to create, view, and manage brainstorming mindmaps using the mindmap terminal module","tags":["mindmap","brainstorming","organization","planning"],"category":"productivity","created":"2026-05-28T15:40:02.250Z","updated":"2026-05-28T15:40:02.250Z"},"webx11-task-manager":{"name":"webx11-task-manager","description":"","tags":["task-management","productivity","vfs","organization"],"category":"system","created":"2026-05-28T16:32:01.429Z","updated":"2026-05-28T16:32:01.430Z"},"mindmap-architect-3d":{"name":"mindmap-architect-3d","description":"","tags":["visual","map","3d","mermaid","ui"],"category":"dev","created":"2026-05-29T00:10:49.903Z","updated":"2026-05-29T00:10:49.903Z"},"mindmap-navigation-pro":{"name":"mindmap-navigation-pro","description":"","tags":["ui","mobile","js","mindmap"],"category":"ui-dev","created":"2026-05-29T00:22:20.790Z","updated":"2026-05-29T00:22:20.790Z"},"agent-optimization-framework":{"name":"agent-optimization-framework","description":"","tags":["optimization","agentic-workflow","efficiency","tool-calls"],"category":"system","created":"2026-05-29T14:52:23.451Z","updated":"2026-05-29T14:52:23.451Z"},"macro-engine-debug":{"name":"macro-engine-debug","description":"","tags":["debug","a-repair","macro"],"category":"system","created":"2026-05-29T15:06:24.057Z","updated":"2026-05-29T15:06:24.057Z"},"macro-engine-onboarding":{"name":"macro-engine-onboarding","description":"","tags":["onboarding","context","macro"],"category":"system","created":"2026-05-29T15:06:24.064Z","updated":"2026-05-29T15:06:24.064Z"},"project-profile-manager":{"name":"project-profile-manager","description":"","tags":["context","memory","workspace"],"category":"system","created":"2026-05-29T15:08:44.897Z","updated":"2026-05-29T15:08:44.897Z"}}
\ No newline at end of file +{ + "navigating-the-terminal": { + "name": "navigating-the-terminal", + "description": "How to explore the WebX11 terminal, find commands, check status, and navigate the filesystem", + "tags": [ + "terminal", + "navigation", + "help", + "filesystem" + ], + "category": "system", + "created": "2026-06-02T13:19:44.542Z", + "updated": "2026-06-02T13:19:44.542Z" + }, + "memory-and-profile": { + "name": "memory-and-profile", + "description": "How to use the user profile system, session memory, and pattern tracking for persistent context", + "tags": [ + "memory", + "profile", + "session", + "persistence" + ], + "category": "system", + "created": "2026-06-02T13:19:44.542Z", + "updated": "2026-06-02T13:19:44.542Z" + }, + "web-search-and-fetch": { + "name": "web-search-and-fetch", + "description": "How to search the web and fetch URL content using the WebX11 proxy API", + "tags": [ + "search", + "fetch", + "web", + "proxy", + "api" + ], + "category": "research", + "created": "2026-06-02T13:19:44.542Z", + "updated": "2026-06-02T13:19:44.542Z" + }, + "module-management": { + "name": "module-management", + "description": "How to view, edit, test, reload modules and manage startup configuration", + "tags": [ + "modules", + "editing", + "code", + "self-improvement" + ], + "category": "dev", + "created": "2026-06-02T13:19:44.542Z", + "updated": "2026-06-02T13:19:44.542Z" + }, + "system-maintenance": { + "name": "system-maintenance", + "description": "How to reset, troubleshoot, and maintain the WebX11 terminal", + "tags": [ + "system", + "maintenance", + "reset", + "troubleshoot", + "config" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "backup-and-restore": { + "name": "backup-and-restore", + "description": "How to backup, restore, and export WebX11 data", + "tags": [ + "backup", + "restore", + "export", + "import", + "persistence" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "mindmap-workflow": { + "name": "mindmap-workflow", + "description": "How to create, view, edit, and manage brainstorming mindmaps", + "tags": [ + "mindmap", + "brainstorming", + "planning", + "organization" + ], + "category": "productivity", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "skills-system-guide": { + "name": "skills-system-guide", + "description": "How to use the skills system: load, create, patch, list, and audit skills for persistent procedural memory", + "tags": [ + "skills", + "system", + "meta" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "agent-orchestration": { + "name": "agent-orchestration", + "description": "How to use the agent registry, leases, and orchestrator for multi-agent workflows", + "tags": [ + "agents", + "orchestration", + "delegation", + "leases" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "debug-panel-and-logs": { + "name": "debug-panel-and-logs", + "description": "How to use the debug panel, session logging, and terminal diagnostics", + "tags": [ + "debug", + "logging", + "diagnostics", + "troubleshooting" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "webdav-operations": { + "name": "webdav-operations", + "description": "How to use WebDAV cloud storage for backup, file sync, and remote file access", + "tags": [ + "webdav", + "cloud", + "backup", + "sync", + "storage" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "security-and-safety": { + "name": "security-and-safety", + "description": "How to use WebX11 security levels, command blocking, and safety features", + "tags": [ + "security", + "safety", + "blocking", + "permissions" + ], + "category": "system", + "created": "2026-06-02T13:19:44.543Z", + "updated": "2026-06-02T13:19:44.543Z" + }, + "mindmap-user-guide": { + "name": "mindmap-user-guide", + "description": "How to create, view, and manage brainstorming mindmaps using the mindmap terminal module", + "tags": [ + "mindmap", + "brainstorming", + "organization", + "planning" + ], + "category": "productivity", + "created": "2026-06-02T13:20:28.672Z", + "updated": "2026-06-02T13:20:28.672Z" + }, + "bug-tracker": { + "name": "bug-tracker", + "description": "Systematic workflow for tracking bugs using a JSON log file in the VFS.", + "tags": [ + "dev", + "debugging", + "management", + "workflow" + ], + "category": "dev", + "created": "2026-06-02T10:10:44.447Z", + "updated": "2026-06-02T10:10:44.447Z" + }, + "task-manager": { + "name": "task-manager", + "description": "A systematic workflow for tracking and managing tasks via a VFS JSON store.", + "tags": [ + "productivity", + "tasks", + "vfs" + ], + "category": "productivity", + "created": "2026-06-02T10:12:44.476Z", + "updated": "2026-06-02T10:12:44.476Z" + }, + "agent-optimization-framework": { + "name": "agent-optimization-framework", + "description": "", + "tags": [ + "optimization", + "agentic-workflow", + "efficiency", + "tool-calls" + ], + "category": "system", + "created": "2026-05-29T14:52:23.451Z", + "updated": "2026-05-29T14:52:23.451Z" + }, + "macro-engine-debug": { + "name": "macro-engine-debug", + "description": "", + "tags": [ + "debug", + "a-repair", + "macro" + ], + "category": "system", + "created": "2026-05-29T15:06:24.057Z", + "updated": "2026-05-29T15:06:24.057Z" + }, + "macro-engine-onboarding": { + "name": "macro-engine-onboarding", + "description": "", + "tags": [ + "onboarding", + "context", + "macro" + ], + "category": "system", + "created": "2026-05-29T15:06:24.064Z", + "updated": "2026-05-29T15:06:24.064Z" + }, + "project-profile-manager": { + "name": "project-profile-manager", + "description": "", + "tags": [ + "context", + "memory", + "workspace" + ], + "category": "system", + "created": "2026-05-29T15:08:44.897Z", + "updated": "2026-05-29T15:08:44.897Z" + } +}
\ No newline at end of file diff --git a/skills/security-and-safety.md b/skills/security-and-safety.md new file mode 100644 index 0000000..bd4f23b --- /dev/null +++ b/skills/security-and-safety.md @@ -0,0 +1,37 @@ +--- +name: security-and-safety +description: How to use WebX11 security levels, command blocking, and safety features +tags: [security, safety, blocking, permissions] +category: system +--- +## Steps +1. **Security levels:** + - security-level <0-3> — set security level: + 0 = Permissive (no blocks, no confirms — anything runs) + 1 = Standard (unknown cmds → AI route, destructive → confirm, system → block) + 2 = Paranoid (unknown cmds blocked entirely, destructive blocked) + 3 = Audit (everything allowed, everything logged) + - Default: level 1 + - security — show current level, blocked count, and stats + +2. **Command control:** + - cmd-allow <cmd> — whitelist a command from security checks + - cmd-deny <cmd> — blacklist/block a command entirely + - whitelist built-in: help, clear, ls, cat, pwd, whoami, df, free, top, ps, echo, date, env, history + +3. **What gets blocked at each level:** + - Unknown commands: Level 1 → AI routed, Level 2+ → blocked + - Destructive commands (delete, write, save, format, etc.): Level 1 → confirmation, Level 2+ → blocked + - System commands (reboot, shutdown, format, kill): Level 1+ → blocked + - Suspicious flags (--execute, --eval, --shell): Level 1+ → blocked + +4. **Safety checklist:** + - Check security: security shows your current level + - Before running risky commands: create a checkpoint first + - For temporary relax: security-level 0, then restore to 1 + - For total lockdown before leaving: security-level 2 + +5. **When to use:** + - User wants to lock down the terminal → security-level 2 + - User wants to allow a blocked command → cmd-allow <cmd> + - Debugging strange behavior → verify security-level (user may have set it higher)
\ No newline at end of file diff --git a/skills/task-manager.md b/skills/task-manager.md new file mode 100644 index 0000000..74c3da1 --- /dev/null +++ b/skills/task-manager.md @@ -0,0 +1,37 @@ +--- +name: task-manager +description: A systematic approach to managing tasks using a JSON-based tracking system in the VFS. +tags: productivity, management, organization +--- + +# Task Management Workflow + +## 1. Initialization +- Check if `/tasks.json` exists. If not, create it with an empty array: `[]`. + +## 2. Adding Tasks +When a new task is identified: +- **Define**: Task name, priority (Low, Medium, High), status (Todo, In-Progress, Done), and deadline. +- **Action**: Read `tasks.json`, append the new task object, and write back to the file. + +## 3. Daily Planning/Review +- **List**: Read `tasks.json` and filter for "Todo" or "In-Progress". +- **Prioritize**: Sort tasks by priority (High > Medium > Low). +- **Update**: Change status of tasks as they are completed. + +## 4. Maintenance +- **Cleanup**: Archive "Done" tasks to `/tasks_archive.json` periodically to keep the main list lean. +- **Audit**: Review overdue tasks and update deadlines or priorities. + +## Schema Reference +```json +{ + "id": "unique-id", + "title": "Task name", + "priority": "High|Medium|Low", + "status": "Todo|In-Progress|Done", + "created_at": "ISO-Date", + "deadline": "ISO-Date", + "notes": "Additional context" +} +```
\ No newline at end of file diff --git a/skills/webdav-operations.md b/skills/webdav-operations.md new file mode 100644 index 0000000..098449c --- /dev/null +++ b/skills/webdav-operations.md @@ -0,0 +1,33 @@ +--- +name: webdav-operations +description: How to use WebDAV cloud storage for backup, file sync, and remote file access +tags: [webdav, cloud, backup, sync, storage] +category: system +--- +## Steps +1. **Configuration:** + - webdav-config — configure WebDAV endpoint URL and credentials + - Connection auto-tested on config; webdav-status shows connection health + - Uses per-user token stored in .token file on the server side + +2. **File operations:** + - webdav-ls [path] — list remote directory contents + - webdav-push <local-path> <remote-path> — upload file to WebDAV + - webdav-pull <remote-path> [local-path] — download file from WebDAV + - webdav-explorer — GUI file browser for WebDAV + - webdav-browser — CLI file browser for WebDAV + +3. **Backup & Restore:** + - webdav-backup — push full VFS snapshot to WebDAV (creates /backups/newos4-<date>.json) + - webdav-backup-list — list all remote backup snapshots + - webdav-restore <filename> — restore VFS from a remote backup snapshot + +4. **Status & Diagnostics:** + - webdav-status — connection status, last sync, space information + - If uploads fail: check webdav-config, ensure .token file is valid + - WebDAV runs on the same server (nginx with WebDAV module), no external dependency + +5. **When to use:** + - Before factory-reset: webdav-backup to store VFS remotely + - Cross-browser: webdav-push/pull to move files between instances + - User says "cloud backup" or "remote save" → webdav-backup
\ No newline at end of file |