diff options
Diffstat (limited to 'skills')
| -rw-r--r-- | skills/agent-optimization-framework.md | 31 | ||||
| -rw-r--r-- | skills/index.json | 134 | ||||
| -rw-r--r-- | skills/macro-engine-debug.md | 10 | ||||
| -rw-r--r-- | skills/macro-engine-onboarding.md | 10 | ||||
| -rw-r--r-- | skills/project-profile-manager.md | 25 |
5 files changed, 77 insertions, 133 deletions
diff --git a/skills/agent-optimization-framework.md b/skills/agent-optimization-framework.md new file mode 100644 index 0000000..78a143d --- /dev/null +++ b/skills/agent-optimization-framework.md @@ -0,0 +1,31 @@ +--- +name: agent-optimization-framework +description: System for reducing tool-call latency and increasing agentic precision through programmatic workflows. +tags: [optimization, agentic-workflow, efficiency, tool-calls] +--- + +# Agent Optimization Framework + +## 🎯 Objective +Transition from manual prompt-based reasoning to a programmatic "Compiler" approach to reduce turns and eliminate hallucinations. + +## 🛠️ Optimization Protocols + +### 1. VFS Cache & Batching (Latency Reduction) +- **Batching:** If a task requires information from multiple files, call `read_file` for all relevant paths in a single turn rather than sequentially. +- **Contextual Caching:** Store the result of `list_files` in temporary memory to avoid redundant calls to the same directory within the same task. + +### 2. Speculative Tool-Calling (Turn Reduction) +- **Anticipation:** Predict the next 2-3 logical steps. If they are independent (e.g., `web_search` followed by `get_status`), execute them in parallel. +- **Pre-fetching:** When a user asks about a module, call `get_module_status` AND `view_module` immediately instead of waiting for the user's second prompt. + +### 3. Strict Validation Loop (Precision) +- **Cross-Reference:** Compare tool output against the `get_help` command reference to ensure parameters are used correctly. +- **Auto-Fallback:** If a `read_file` returns empty, immediately try `list_files` to verify the path before reporting a failure to the user. + +## 🔄 Implementation Workflow +1. **REASON:** Identify the target goal and all required dependencies. +2. **BATCH:** Group all independent data-gathering tool calls. +3. **EXECUTE:** Run the batch. +4. **VALIDATE:** Verify the output against the expected schema. +5. **REFINE:** If the result is missing or incorrect, trigger the auto-fallback protocol. diff --git a/skills/index.json b/skills/index.json index 373efdf..6d57936 100644 --- a/skills/index.json +++ b/skills/index.json @@ -1,133 +1 @@ -{ - "web-search-and-fetch": { - "name": "web-search-and-fetch", - "description": "How to search the web and fetch URL content using the WebX11 proxy API", - "category": "research", - "tags": [ - "search", - "fetch", - "web", - "proxy", - "api" - ] - }, - "webdav-sync": { - "name": "webdav-sync", - "description": "Sync, backup, and restore VFS via WebDAV in WebX11. CRITICAL: Only use verified commands.", - "category": "system", - "tags": [ - "webdav", - "sync", - "backup", - "cloud", - "vfs" - ] - }, - "test": { - "name": "test", - "description": "No description", - "category": "general", - "tags": [] - }, - "module-management": { - "name": "module-management", - "description": "How to view, edit, test, reload modules and manage startup configuration", - "category": "dev", - "tags": [ - "modules", - "editing", - "code", - "self-improvement" - ] - }, - "backup-and-restore": { - "name": "backup-and-restore", - "description": "How to backup, restore, and export WebX11 data", - "category": "system", - "tags": [ - "backup", - "restore", - "export", - "import", - "persistence" - ] - }, - "navigating-the-terminal": { - "name": "navigating-the-terminal", - "description": "How to explore the WebX11 terminal, find commands, check status, and navigate the filesystem", - "category": "system", - "tags": [ - "terminal", - "navigation", - "help", - "filesystem" - ] - }, - "system-maintenance": { - "name": "system-maintenance", - "description": "How to reset, troubleshoot, and maintain the WebX11 terminal", - "category": "system", - "tags": [ - "system", - "maintenance", - "reset", - "troubleshoot", - "config" - ] - }, - "mindmap-workflow": { - "name": "mindmap-workflow", - "description": "How to create, view, edit, and manage brainstorming mindmaps", - "category": "productivity", - "tags": [ - "mindmap", - "brainstorming", - "planning", - "organization" - ] - }, - "webx11-dev-cycle": { - "name": "webx11-dev-cycle", - "description": "Professional workflow for analyzing, prototyping, and implementing new features in WebX11.", - "category": "general", - "tags": [] - }, - "mindmap-user-guide": { - "name": "mindmap-user-guide", - "description": "How to create, view, and manage brainstorming mindmaps using the mindmap terminal module", - "category": "productivity", - "tags": [ - "mindmap", - "brainstorming", - "organization", - "planning" - ] - }, - "memory-and-profile": { - "name": "memory-and-profile", - "description": "How to use the user profile system, session memory, and pattern tracking for persistent context", - "category": "system", - "tags": [ - "memory", - "profile", - "session", - "persistence" - ] - }, - "memory-map": { - "name": "memory-map", - "description": "Maintain and query the persistent memory map at /memory/map.json for Agando/DarkMoto Systems.", - "category": "system", - "tags": [] - }, - "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", - "category": "system", - "tags": [ - "skills", - "system", - "meta" - ] - } -}
\ 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-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 diff --git a/skills/macro-engine-debug.md b/skills/macro-engine-debug.md new file mode 100644 index 0000000..cd43a29 --- /dev/null +++ b/skills/macro-engine-debug.md @@ -0,0 +1,10 @@ +--- +name: macro-engine-debug +description: A compound operation to audit, view, and test a module in one logical flow. +steps: + 1. Call get_module_status to identify if the module is loaded/modified. + 2. Call view_module(name) to analyze the source. + 3. Call run_command('test-module <name>') or similar health checks. + 4. Synthesize a health report. +tags: [debug, a-repair, macro] +--- diff --git a/skills/macro-engine-onboarding.md b/skills/macro-engine-onboarding.md new file mode 100644 index 0000000..46c2677 --- /dev/null +++ b/skills/macro-engine-onboarding.md @@ -0,0 +1,10 @@ +--- +name: macro-engine-onboarding +description: A rapid context-recovery sequence to understand current session state. +steps: + 1. Call session_recent(3) to see previous work. + 2. Call list_files('') to see current root state. + 3. Call load_skills('current-task') to find relevant procedures. + 4. Call user_list to check for project-specific flags. +tags: [onboarding, context, macro] +--- diff --git a/skills/project-profile-manager.md b/skills/project-profile-manager.md new file mode 100644 index 0000000..03eead8 --- /dev/null +++ b/skills/project-profile-manager.md @@ -0,0 +1,25 @@ +--- +name: project-profile-manager +description: Handles saving and loading of project-specific context bundles. +tags: [context, memory, workspace] +--- + +# Project Profile Manager + +## Profile Structure +Profiles are stored in `/profiles/<name>.json` containing: +- `preferences`: Key-value pairs for `user_set` +- `required_skills`: List of skills to be loaded via `load_skills` +- `working_dir`: The primary VFS path for the project +- `session_anchor`: Last known session date/ID + +## Workflow: Save +1. Capture current working directory using `get_current_dir`. +2. Retrieve relevant `user_list` keys. +3. Save as JSON to `/profiles/`. + +## Workflow: Load +1. Read `/profiles/<name>.json`. +2. Apply `user_set` for all stored preferences. +3. Call `load_skills` for all registered project skills. +4. Navigate to `working_dir`. |