config-setup SKILL.md skillB

config-setup from open-octo/octo-agent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add open-octo/octo-agent/config-setup@git:20260924.b98ea0b

Pins git:20260924.b98ea0b in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
open-octo/octo-agent
Path
internal/skills/defaults/config-setup/SKILL.md
Versions recorded
7
Latest version
git:20260924.b98ea0b, committed Sep 24, 2026
First version recorded
Jul 26, 2026
Size
13,305 bytes
Repository stars
140
License
MIT

Configure octo's global settings through guided conversation — set up AI model endpoints (providers, API keys, models), adjust agent defaults (reasoning effort, permission mode, coauthor, workspace directory), and manage the default/lite model assignments. Trigger on: "configure model", "add provider", "setup endpoint", "add API key", "change default model", "switch model", "set reasoning", "change permission mode", "config setup", "配置模型", "添加模型", "配置 API", "切换模型", "修改设置".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Configure octo

Your job is to turn "I need my agent to use model X" or "change setting Y" into a
working configuration through octo's REST API. Not every user knows where
settings live — briefly explain when needed.

## Two categories of configuration

```
Agent Defaults                    Endpoints & Models
─────────────────                 ───────────────────
reasoning_effort                  provider selection
permission_mode                   API key
show_reasoning                    base URL (advanced)
coauthor                          model names
workspace_dir                     default / lite model
```

All of these live in `~/.octo/config.yml` and are editable through the REST API
on the running octo server at `http://localhost:<port>` (use `curl` via the `terminal` tool — do NOT use `web_fetch`, localhost is blocked by SSRF).

## Reaching the server

The server listens on `127.0.0.1:8088` by default (the desktop app's built-in
server uses the same port). Loopback requests need no access key.

A session running inside the server (Web UI, desktop, IM) has an `Octo server:`
line in its Environment section. When it's there, use that address in place of
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add open-octo/octo-agent/config-setup@sha256:174957a4537e1062

The line at the top of this page pins the label git:20260924.b98ea0b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ihyqk5vmn6mkqd3m.svg)](https://markdownregistry.com/a/art_ihyqk5vmn6mkqd3m)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Jul 26, 2026 and Sep 24, 2026, about one every 10 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20260924.b98ea0b latest2026-09-24 b98ea0b 13,305 BB view · diff
git:20260910.d32ed192026-09-10 d32ed19 13,071 BB view · diff
git:20260802.521e2d42026-08-02 521e2d4 12,997 BB view · diff
git:20260727.db140172026-07-27 db14017 12,903 BB view · diff
git:20260726.d3603962026-07-26 d360396 11,897 BA view · diff
git:20260726.859d3c12026-07-26 859d3c1 9,538 BA view · diff
git:20260726.5703ed32026-07-26 5703ed3 9,462 BA view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8088)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13305 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

open-octo/octo-agent · 140 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ihyqk5vmn6mkqd3m
GET https://markdownregistry.com/api/v1/resolve?ref=open-octo/octo-agent/config-setup
GET https://markdownregistry.com/api/v1/blob/174957a4537e106285a2162dc8225e71cc80d19b0be99cb012a24cd4556e9918

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from open-octo/octo-agent

CLAUDE.md CLAUDE.md file
open-octo/octo-agent · CLAUDE.md
git:20261014.4ebb825 · audit A · 140 stars
artifact-design SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/artifact-design/SKILL.md · Design guidance for any HTML/Markdown file shown in octo's Artifacts panel — reports, dashboards, architecture/system…
git:20260923.bfb1a61 · audit B · 140 stars
channel-manager SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/channel-manager/SKILL.md · Configure IM platform channels (Feishu, Weixin/WeChat, WeCom, DingTalk, Discord, Telegram) for octo. Guides the user…
git:20260924.b98ea0b · audit B · 140 stars
code-review SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/code-review/SKILL.md · Review local code changes. Uses an isolated sub-agent for unbiased analysis when the main agent wrote the code; reviews…
git:20260920.c947ee9 · audit A · 140 stars
cron-task-creator SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/cron-task-creator/SKILL.md · Create, inspect, run, edit, enable/disable, and delete octo's scheduled cron tasks — recurring agent prompts stored in…
git:20261012.05c8065 · audit B · 140 stars
deep-research SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/deep-research/SKILL.md
git:20260807.58b8c70 · audit B · 140 stars
expert-agent-manager SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/expert-agent-manager/SKILL.md · Manage octo's agent profiles through conversation — create, modify, delete, list, and bind agents to IM chats by…
git:20260924.b98ea0b · audit A · 140 stars
genui SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/genui/SKILL.md · Render structured, glanceable, interactive UI in the chat instead of plain text — dashboards, stat cards, filterable…
git:20260923.e099c80 · audit A · 140 stars
grill-me SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/grill-me/SKILL.md
git:20260713.070d20e · audit B · 140 stars
image-gen SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/image-gen/SKILL.md · Acquire images as files — generate them with an AI image model (14 providers: OpenAI/gpt-image, Gemini, Qwen, Zhipu…
git:20260907.f18641e · audit A · 140 stars
implement SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/implement/SKILL.md · Implement a technical design by decomposing it into dependency-ordered vertical slices, executing each with TDD…
git:20260711.2cb5a53 · audit A · 140 stars
mcp-creator SKILL.md skill
open-octo/octo-agent · internal/skills/defaults/mcp-creator/SKILL.md · Configure and connect MCP (Model Context Protocol) servers through guided conversation — find the right server package…
git:20260802.3c4aeb5 · audit A · 140 stars

Every file in open-octo/octo-agent

Browse by kind, by grade B, or by owner.