Agent skill

Settings Guide Skill

by OpenLoaf in OpenLoaf/OpenLoaf

当用户问 OpenLoaf 桌面端产品内的设置、偏好、API key、模型切换、主题 / 语言 / 快捷键 / 代理 / 备份、或相关故障(key invalid、model not found)该在哪配置、怎么配置时触发。不用于:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。

AGPL-3.0Auto-check: notes

Install Settings Guide Skill

skills CLI
$ npx skills add OpenLoaf/OpenLoaf --skill settings-guide-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenLoaf/OpenLoaf settings-guide-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenLoaf/OpenLoaf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/server/src/ai/builtin-skills/settings-guide .claude/skills/settings-guide-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
settings-guide-skill
GitHub stars
108
Token cost
~539 tokens
SKILL.md length
135 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
AGPL-3.0

At a glance

当用户问 OpenLoaf 桌面端产品内的设置、偏好、API key、模型切换、主题 / 语言 / 快捷键 / 代理 / 备份、或相关故障(key invalid、model not found)该在哪配置、怎么配置时触发。不用于:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。

  • Works in 4 steps: 先明确用户想改什么 → 查上方配置地图 → 给出具体路径,不要说"去设置里找找" → 如果是排障 → 走决策树,逐步缩小范围 → …
  • SKILL.md covers 工具清单, 配置地图, 故障排查决策树 and 必须遵守的安全原则, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Settings Guide Skill is an agent skill from OpenLoaf/OpenLoaf. 当用户问 OpenLoaf 桌面端产品内的设置、偏好、API key、模型切换、主题 / 语言 / 快捷键 / 代理 / 备份、或相关故障(key invalid、model not found)该在哪配置、怎么配置时触发。不用于:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with TypeScript. The repository describes itself as: 🍞Open-source, local-first AI workspace with Agents, multi-model chat (GPT/Claude/Gemini/DeepSeek), Notion-like docs, AI image & video generation, email, calendar & terminal…. The licence is AGPL-3.0.

Example prompts

  • “/settings-guide-skill”

Workflow steps

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

  1. 先明确用户想改什么 → 查上方配置地图
  2. 给出具体路径,不要说"去设置里找找"
  3. 如果是排障 → 走决策树,逐步缩小范围
  4. 涉及 API Key → 只说"请在设置 UI 中操作",不要求用户贴 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 539 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~539

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

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:4
    置、怎么配置时触发。**不用于**:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。

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). 135 words, ~539 tokens.

Download SKILL.mdSave it as .claude/skills/settings-guide-skill/SKILL.md (or your agent's skills folder).
name
settings-guide-skill
description
当用户问 OpenLoaf 桌面端产品内的设置、偏好、API key、模型切换、主题 / 语言 / 快捷键 / 代理 / 备份、或相关故障(key invalid、model not found)该在哪配置、怎么配置时触发。**不用于**:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。

设置引导(无直接工具)

工具清单

本 skill 无直接工具。作用是告诉用户在桌面端 UI 中去哪里完成设置操作,并解释配置项背后的原理 — 相当于一份内置的可搜索产品手册。

配置地图

用户想改什么 → 告诉他去哪里:

需求路径
语言/主题/快捷键设置 → 基础设置
添加/编辑 AI Provider设置 → AI 模型 → Provider 管理
配置 API Key设置 → AI 模型 → 对应 Provider → 编辑
切换默认模型设置 → AI 模型 → 模型选择
添加自定义模型设置 → AI 模型 → 自定义模型(需兼容 OpenAI API 格式)
项目路径/Git 设置设置 → 项目
临时存储路径设置 → 基础设置 → 临时存储路径
代理/Proxy 设置设置 → 基础设置 → 网络代理
数据导出设置 → 基础设置 → 数据管理 → 导出
备份与恢复设置 → 基础设置 → 数据管理 → 备份
存储空间查看设置 → 基础设置 → 存储空间

兜底规则:如果用户的需求不在上表中,引导用户到设置首页并使用搜索功能定位具体选项。

故障排查决策树

AI 无响应 / 报错
├── "API key invalid" → 设置 → AI 模型 → 检查对应 Provider 的 Key
├── "model not found" → Provider 的 baseURL 是否正确?自定义模型 ID 是否匹配?
├── 能发送但无回复 → 检查网络 / 代理设置,确认 Provider 服务可达
└── 回复乱码 → 换一个支持中文的模型

邮件/日历不工作
├── 未显示 → 设置中确认已启用对应账户
└── 同步失败 → 账户授权可能过期,重新授权

终端不工作
├── 无法打开 → 检查终端路径设置是否正确(设置 → 基础设置 → 终端)
├── 命令执行失败 → 确认 shell 路径和环境变量配置
└── 显示异常 → 尝试重启终端会话或清除终端缓存

编辑器问题
├── 无法保存 → 检查文件权限和磁盘空间
├── 语法高亮失效 → 确认文件类型识别正确,尝试手动选择语言模式
└── 代码补全不工作 → 确认 AI 模型配置正常,检查网络连接

文件管理器问题
├── 目录不显示 → 检查项目路径设置(设置 → 项目)
├── 文件操作失败 → 确认文件系统权限
└── 搜索无结果 → 确认搜索范围和索引状态

界面问题
├── 语言没切换 → 刷新页面或重启应用(缓存未更新)
├── 主题不生效 → 确认未设为"跟随系统"导致覆盖
└── Widget 加载失败 → 使用 WidgetCheck 查看编译错误

必须遵守的安全原则

  • 绝不在对话中展示 API Key。为什么?对话内容可能被日志记录或屏幕共享暴露。引导用户去设置 UI 中查看/修改。
  • Provider 变更后建议重启。为什么?模型连接池在启动时初始化,运行时切换 Provider 可能不会立即生效。
  • 模型切换影响全局。切换默认模型会影响所有新对话,建议用户先在新对话中测试效果。

隐私说明(用户问及时告知)

  • 所有数据本地存储(SQLite),不上传云端
  • API Key 加密存储在本地数据库
  • 仅在调用 AI API 和邮件/日历同步时联网

常见错误示范

错误回答正确回答
"去设置里找找看""设置 → AI 模型 → Provider 管理 → 点击对应 Provider → 编辑 API Key"
"你可以在设置中调整""设置 → 基础设置 → 网络代理,填入你的代理地址(如 http://127.0.0.1:7890)"
"应该能在某个地方改""设置 → 基础设置 → 主题,选择「深色」即可切换深色模式"

回答策略

  1. 先明确用户想改什么 → 查上方配置地图
  2. 给出具体路径,不要说"去设置里找找"
  3. 如果是排障 → 走决策树,逐步缩小范围
  4. 涉及 API Key → 只说"请在设置 UI 中操作",不要求用户贴 Key

© 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 of OpenLoaf/OpenLoaf.

Open the folder on GitHubat commit f7eccf6

Compare with similar skills

Settings Guide Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Settings Guide Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Settings Guide Skill this skillOpenLoaf/OpenLoaf108—~539Automated safety check: NotesAGPL-3.0
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Nx Import

    nrwl/nx

    Import, merge, or combine repositories into an Nx workspace using nx import.

    29k GitHub starsUsed in 6 repos~3.5k tokens
    DevelopmentAuto-check passed

More from OpenLoaf/OpenLoaf

All 33 skills in this repo
  • Agent Orchestration Skill

    OpenLoaf/OpenLoaf

    Triggers when the master Agent faces a multi-step complex task and is deciding whether / how to outsource sub-tasks to built-in subagents (browser / doc-editor / data-analyst / extractor /…

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Browser Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user asks for page-level interaction with a specific webpage: login, form filling, button clicks, pagination scraping, screenshots, downloading page images, handling CAPTCHAs or…

    108 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed
  • Canvas Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user wants lifecycle management of OpenLoaf canvases / whiteboards: create, open, filter, duplicate, delete, rename, or change ownership.

    108 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Reads, edits, converts and reviews Word documents through three dedicated tools, covering tracked changes, comments, tables, images and format conversion.

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Email Operations

    OpenLoaf/OpenLoaf

    Handles a real email account through query and mutate tools: check the inbox, read, search, reply, forward, compose and organize, with sending always confirmed first.

    108 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Desktop Control

    OpenLoaf/OpenLoaf

    Guides an agent to operate native macOS apps by surveying an app first, acting through intents, menus or keystrokes, and verifying each step, in OpenLoaf Desktop only.

    108 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Settings Guide Skill

What does Settings Guide Skill do?

当用户问 OpenLoaf 桌面端产品内的设置、偏好、API key、模型切换、主题 / 语言 / 快捷键 / 代理 / 备份、或相关故障(key invalid、model not found)该在哪配置、怎么配置时触发。不用于:项目里的代码配置文件如 tsconfig / .env(→直接用 Read/Edit)、一般编程问题(→直接回答)、系统级 OS 设置。. Settings Guide Skill is an agent skill from OpenLoaf/OpenLoaf.

How do I install Settings Guide Skill in Claude Code?

Run `npx skills add OpenLoaf/OpenLoaf --skill settings-guide-skill -a claude-code`. Or copy the skill folder (apps/server/src/ai/builtin-skills/settings-guide in OpenLoaf/OpenLoaf) into .claude/skills/settings-guide-skill in your project. Claude Code loads it when a task matches its description.

How do I install Settings Guide Skill in Codex?

Run `npx skills add OpenLoaf/OpenLoaf --skill settings-guide-skill -a codex`. Or copy the skill folder (apps/server/src/ai/builtin-skills/settings-guide in OpenLoaf/OpenLoaf) into .agents/skills/settings-guide-skill in your project. Codex loads it when a task matches its description.

Can I use Settings Guide Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenLoaf/OpenLoaf --skill settings-guide-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/settings-guide-skill, .gemini/skills/settings-guide-skill, .github/skills/settings-guide-skill and .opencode/skills/settings-guide-skill in your project.

What does Settings Guide Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Settings Guide Skill is instructions for the agent only.

Does Settings Guide Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Settings Guide Skill safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Settings Guide Skill use?

Settings Guide Skill is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Settings Guide Skill use?

About 539 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Settings Guide Skill?

Skills that share tags, products or a category with Settings Guide Skill: MCP Server Builder (anthropics/skills, 180k stars), Web Artifacts Builder (anthropics/skills, 180k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Settings Guide Skill?

OpenLoaf (a GitHub organization) maintains it in OpenLoaf/OpenLoaf, which has 108 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on May 14, 2026.

Source: OpenLoaf/OpenLoaf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.