michat-user-support
npx machina-cli add skill filmicgaze/MiChat-desktop/michat-user-support --openclawPurpose
Use this skill when the user is having trouble using MiChat itself (tools unavailable, settings not taking effect, confusion about where something is in the UI).
This skill is about operating within MiChat (the current environment), not about the user’s external task domain.
Authority order
- If the active profile has a more specific relevant skill, follow that first.
- Otherwise, use the global MiChat library docs:
- MiChat Operating Guide (for assistants)
- MiChat Troubleshooting (for assistants)
How to consult the docs (practical)
Use library retrieval, not memory.
- If you need a fact but don’t know where it lives:
- use
library_search(query)with concrete queries (e.g."Working folder","Reset session now","Allow agent to edit its skills").
- use
- Once you find the right area:
- use
library_meta(path)to get headings, then - use
library_read_section(path, heading_id)to read the smallest relevant section.
- use
Prefer reading one section and acting, rather than loading whole documents.
Core posture
- Be evidence-led: use tool results and error envelopes; don’t guess.
- Ask one good question at a time.
- Don’t invent missing capabilities or toolsets.
Triage loop (lightweight)
- Clarify the symptom in one sentence: what were they trying to do?
- If a tool call failed, read:
error_type(primary clue)retryable(whether a retry might help)
- Check MiChat’s common gates (most common first):
- Session reset banner (settings changed but user didn’t click Reset session now)
- Working folder /
workspace_root(needed for documents/filesystem/open_file) - Permission toggles (e.g. web browsing; allow agent to edit its skills)
- Credentials (Settings → Credentials)
- Give one targeted UI instruction (with UI landmarks) and stop.
- Re-attempt the minimal tool call to verify the fix (assistant-side) if the relevant tool exists.
Known high-value checks
Settings changes not taking effect
- Ask whether Settings shows the banner:
- “Changes apply after resetting the agent session.”
- Button: “Reset session now”.
Documents/filesystem tools unavailable
- Guide user to: Settings → Paths → Working folder
- Remember: documents tools can read
.md/.txt/.json/.jsonl/.html/.htm, but write.md/.txt/.html/.htm.
Path errors
- Ensure the path is under the working folder and not using
..traversal.
When to hand off to the MiChat Assistant profile
If the user’s request is about MiChat development or advanced configuration, do not attempt to solve it in-place.
Examples:
- creating/modifying profiles
- adding new tools/toolsets/actions
- extending or changing the codebase
- editing global library content
Instead: instruct the user to switch to the MiChat Assistant profile and continue there.
Source
git clone https://github.com/filmicgaze/MiChat-desktop/blob/main/profiles/_global/skills/michat-user-support/SKILL.mdView on GitHub Overview
Helps diagnose and fix MiChat issues inside the current environment. It checks common gates like session reset, working folder, permissions, and credentials, and consults the global MiChat reference docs for precise guidance.
How This Skill Works
When a problem is reported, the skill follows a lightweight triage loop, reads error details, and targets the appropriate gate. It relies on library_search, library_meta, and library_read_section to fetch the exact steps from the MiChat Operating Guide and Troubleshooting docs rather than guessing.
When to Use It
- User reports tools/features in MiChat are unavailable
- Settings changes do not take effect after updates
- Documents or filesystem tools fail to access the working folder
- Path or permission errors prevent file access
- Credentials or access settings seem misconfigured
Quick Start
- Step 1: Clarify the symptom in one sentence
- Step 2: Use library_search(query) to locate relevant MiChat gates (e.g., 'Working folder', 'Reset session now', 'Credentials')
- Step 3: Read the smallest relevant section with library_meta and library_read_section, then give a focused UI instruction and re-check
Best Practices
- Follow the lightweight triage loop and clarify the symptom in one sentence
- Trust evidence from tool responses and error envelopes over guesses
- Check common gates in order: session reset, working folder, permissions, credentials
- Ask one good question at a time and avoid overloading the user
- Consult MiChat global docs via library_search and read the smallest relevant section
Example Use Cases
- Example: User can't run a document tool; guide them to Settings → Paths → Working folder and confirm read permissions
- Example: Settings changes don’t apply; check the reset session banner and perform 'Reset session now'
- Example: Web browsing permission toggled off; enable permissions or the relevant toggle (e.g., 'allow agent to edit its skills')
- Example: Path error with '..' traversal; correct to a path under the working folder
- Example: Credentials misconfigured; open Settings → Credentials and verify/renew them
