diff --git a/crates/zeroclaw-channels/src/discord/types.rs b/crates/zeroclaw-channels/src/discord/types.rs
index 73b5fa67567..5af2076c8ed 100644
--- a/crates/zeroclaw-channels/src/discord/types.rs
+++ b/crates/zeroclaw-channels/src/discord/types.rs
@@ -117,7 +117,7 @@ impl DiscordOutgoing {
 /// 100-char limit; `options` are the typed command options (empty → the legacy
 /// single free-text `input`).
 ///
-/// `Eq` is not derived: [`OptionSpec`] carries `f64` numeric bounds.
+/// `Eq` is not derived: `OptionSpec` carries `f64` numeric bounds.
 #[derive(Debug, Clone, PartialEq)]
 pub struct DiscordSlashCommandSpec {
     pub skill_name: String,
diff --git a/crates/zeroclaw-config/src/sections.rs b/crates/zeroclaw-config/src/sections.rs
index da2cc56f1b1..09deca19f7f 100644
--- a/crates/zeroclaw-config/src/sections.rs
+++ b/crates/zeroclaw-config/src/sections.rs
@@ -451,7 +451,7 @@ sections! {
         shape: TypedFamilyMap,
         group: Foundation,
         help:  "Pick which chat platforms ZeroClaw should listen on. Global \
-                channel settings live on [channels]; each configured platform \
+                channel settings live on `[channels]`; each configured platform \
                 still gets its own alias.",
     },
     Hardware => {
diff --git a/crates/zeroclaw-runtime/src/skills/cache.rs b/crates/zeroclaw-runtime/src/skills/cache.rs
index 718eadebae7..f624fc8a5e0 100644
--- a/crates/zeroclaw-runtime/src/skills/cache.rs
+++ b/crates/zeroclaw-runtime/src/skills/cache.rs
@@ -1,6 +1,6 @@
 //! Process-global cache for skill-directory loads.
 //!
-//! [`super::load_skills_from_directory`] and [`super::load_open_skills_from_directory`]
+//! [`super::load_skills_from_directory`] and `super::load_open_skills_from_directory`
 //! are pure functions of `(dir, allow_scripts, filesystem state)`, but each call
 //! does a recursive read *and* a full security audit (content scan + parse) of
 //! every skill subdirectory. They run on every prompt build and every