Settings Guide Skill

What it does

When your agent uses it

• The user asks about settings
• Model switching
• Theme / language / shortcuts / proxy / backup
• Related failures (key invalid

Example prompts

• “Use the settings-guide-skill skill to trigger when the user asks about settings, preferences, API keys, model switching, theme / language /…”
• “/settings-guide-skill”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1First nail down what the user wants to change → look it up in the Configuration Map above
2. 2Give the exact path — never say "go find it in Settings"
3. 3If it's troubleshooting → walk the decision tree, narrowing down step by step
4. 4Anything involving an API Key → only say "please do it in the Settings UI"; never ask the user to paste a Key

What it can do on your machine

Read from SKILL.md and the folder at commit f7eccf6. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Settings Guide Skill loads about 1.3k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~118

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:4

  iles inside a project such as tsconfig / .env (→ use Read/Edit directly), general programming questions (→ answer direct

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenLoaf/OpenLoaf at commit f7eccf6, republished under its AGPL-3.0 licence (© OpenLoaf). 424 words, ~1,262 tokens.

name

settings-guide-skill

description

Triggers when the user asks about settings, preferences, API keys, model switching, theme / language / shortcuts / proxy / backup, or related failures (key invalid, model not found) within the OpenLoaf desktop product — where to configure and how to configure them. **Not for**: code configuration files inside a project such as tsconfig / .env (→ use Read/Edit directly), general programming questions (→ answer directly), or system-level OS settings.

AI unresponsive / errors
├── "API key invalid" → Settings → AI Models → check the Key for the relevant Provider
├── "model not found" → Is the Provider's baseURL correct? Does the custom model ID match?
├── Can send but no reply → Check network / proxy settings, confirm the Provider endpoint is reachable
└── Garbled reply → Switch to a model that supports your target language

Email / Calendar not working
├── Not showing up → In Settings, confirm the account is enabled
└── Sync failing → Account authorization may have expired; re-authorize

Terminal not working
├── Won't open → Check that the terminal path setting is correct (Settings → General → Terminal)
├── Commands fail to execute → Verify the shell path and environment variable configuration
└── Display glitches → Try restarting the terminal session or clearing the terminal cache

Editor issues
├── Cannot save → Check file permissions and disk space
├── Syntax highlighting broken → Confirm the file type is detected correctly; try manually selecting a language mode
└── Code completion not working → Confirm the AI model is configured correctly and check network connectivity

File manager issues
├── Directory not showing → Check the project path setting (Settings → Projects)
├── File operations fail → Confirm file system permissions
└── Search returns nothing → Confirm the search scope and index status

UI issues
├── Language didn't switch → Refresh the page or restart the app (stale cache)
├── Theme not applied → Confirm it isn't set to "Follow system", which can override the choice
└── Widget fails to load → Use WidgetCheck to inspect compile errors

© OpenLoaf, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in apps/server/src/ai/builtin-skills/settings-guide/en of OpenLoaf/OpenLoaf.

Open the folder on GitHubat commit f7eccf6