feat: configurable skills path

codex-rs/Cargo.toml

@@ -223,6 +223,7 @@ tracing-test = "0.2.5"
 tree-sitter = "0.25.10"
 tree-sitter-bash = "0.25"
 zstd = "0.13"
+zip = "2.2.0"
 tree-sitter-highlight = "0.25.10"
 ts-rs = "11"
 tui-scrollbar = "0.2.2"

codex-rs/core/Cargo.toml

@@ -96,6 +96,7 @@ url = { workspace = true }
 uuid = { workspace = true, features = ["serde", "v4", "v5"] }
 which = { workspace = true }
 wildmatch = { workspace = true }
+zip = { workspace = true }
 
 [features]
 deterministic_process_ids = []

codex-rs/core/src/config/mod.rs

@@ -13,6 +13,7 @@ use crate::config::types::SandboxWorkspaceWrite;
 use crate::config::types::ScrollInputMode;
 use crate::config::types::ShellEnvironmentPolicy;
 use crate::config::types::ShellEnvironmentPolicyToml;
+use crate::config::types::SkillsConfigToml;
 use crate::config::types::Tui;
 use crate::config::types::UriBasedFileOpener;
 use crate::config_loader::ConfigLayerStack;
@@ -881,6 +882,10 @@ pub struct ConfigToml {
     /// output will be hyperlinked using the specified URI scheme.
     pub file_opener: Option<UriBasedFileOpener>,
 
+    /// Additional skill sources to load from local paths or URLs.
+    #[serde(default)]
+    pub skills: Option<SkillsConfigToml>,
+
     /// Collection of settings that are specific to the TUI.
     pub tui: Option<Tui>,
 

codex-rs/core/src/config/types.rs

@@ -283,6 +283,34 @@ impl UriBasedFileOpener {
     }
 }
 
+/// Configuration for additional skill sources.
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, Default, JsonSchema)]
+#[schemars(deny_unknown_fields)]
+pub struct SkillsConfigToml {
+    /// Additional skill sources to load. Each entry can be a local path or a URL.
+    #[serde(default)]
+    pub sources: Vec<SkillSourceToml>,
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema)]
+#[serde(untagged)]
+pub enum SkillSourceToml {
+    Path(SkillSourcePathToml),
+    Url(SkillSourceUrlToml),
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema)]
+#[schemars(deny_unknown_fields)]
+pub struct SkillSourcePathToml {
+    pub path: AbsolutePathBuf,
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema)]
+#[schemars(deny_unknown_fields)]
+pub struct SkillSourceUrlToml {
+    pub url: String,
+}
+
 /// Settings that govern if and what will be written to `~/.codex/history.jsonl`.
 #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default, JsonSchema)]
 #[schemars(deny_unknown_fields)]