more

docs/config.md

@@ -18,6 +18,21 @@ Codex can run a notification hook when the agent finishes a turn. See the config
 
 - https://developers.openai.com/codex/config-reference
 
+## Skills sources
+
+You can add extra skill sources in `config.toml` using the `[skills]` table:
+
+```toml
+[skills]
+sources = [
+  { path = "/path/to/skills" },
+  { url = "https://example.com/my-skill.skill" }
+]
+```
+
+- `path` should point to a directory that contains one or more skill folders with `SKILL.md`.
+- `url` can point to a `.skill` (zip) archive or a raw `SKILL.md`. Remote skills are cached under `~/.codex/skills/.remote/`.
+
 ## JSON Schema
 
 The generated JSON Schema for `config.toml` lives at `codex-rs/core/config.schema.json`.