auto: 2026-06-03_06:00 changes

1 files changed, 17 insertions, 7 deletions

diff --git a/skills/macro-engine-onboarding.md b/skills/macro-engine-onboarding.md
index 46c2677..669d665 100644
--- a/skills/macro-engine-onboarding.md
+++ b/skills/macro-engine-onboarding.md
@@ -1,10 +1,20 @@
 ---
 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]
+description: A rapid context-recovery sequence to align the AI with the current session state and active projects.
+tags: [onboarding, context, recovery, macro]
+category: system
 ---
+
+# Macro Engine Onboarding
+
+## 🎯 Objective
+Efficiently recover state and context at the start of a session to avoid redundant queries and minimize hallucinations.
+
+## 🛠️ Execution Steps
+1. **Session Review:** Call `session_recent(3)` to identify the last active tasks and their outcomes.
+2. **VFS Snapshot:** Call `list_files('')` to examine the root directory for new project files or configuration changes.
+3. **Procedure Retrieval:** Call `load_skills('current-task')` to see if any stored procedures are applicable to the immediate goal.
+4. **User Preferences:** Call `user_list` to check for project-specific flags or persistent preferences (e.g., preferred models, project paths).
+
+## 🔄 Workflow
+`session_recent` ➔ `list_files` ➔ `load_skills` ➔ `user_list`