diff --git a/docs/fish-config.1 b/docs/fish-config.1
index f46b9e1..af98946 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -1135,6 +1135,31 @@ Example:
 mkdir \[ti]/projects/myapp/src
 \f[R]
 .fi
+.SS mv
+.IP
+.nf
+\f[C]
+Synopsis:  mv [args...]
+
+Wraps mv to automatically collapse nested directories of the same name.
+When extracting archives results in redundant structures (e.g.,
+themes/themes/), calling \[ga]mv themes/themes themes\[ga] will gracefully
+move the inner contents up one level and remove the empty outer shell.
+
+Opinionated component (C1): when disabled via __fish_config_op_aliases,
+behaves exactly like bare command mv.
+
+Arguments:
+  args...  Arguments forwarded to standard mv
+
+Exit Status:
+  0  Operation succeeded
+  >0 Standard mv failure, or failed to collapse directory
+
+Example:
+mv \[ti]/.config/btop/themes/themes \[ti]/.config/btop/themes
+\f[R]
+.fi
 .SS poke
 .IP
 .nf
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 623964d..26af1f3 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -792,6 +792,28 @@ functions). They are active in all interactive sessions.
     Example:
     mkdir ~/projects/myapp/src
 
+### mv
+
+    Synopsis:  mv [args...]
+
+    Wraps mv to automatically collapse nested directories of the same name.
+    When extracting archives results in redundant structures (e.g.,
+    themes/themes/), calling `mv themes/themes themes` will gracefully
+    move the inner contents up one level and remove the empty outer shell.
+
+    Opinionated component (C1): when disabled via __fish_config_op_aliases,
+    behaves exactly like bare command mv.
+
+    Arguments:
+      args...  Arguments forwarded to standard mv
+
+    Exit Status:
+      0  Operation succeeded
+      >0 Standard mv failure, or failed to collapse directory
+
+    Example:
+    mv ~/.config/btop/themes/themes ~/.config/btop/themes
+
 ### poke
 
     Synopsis:  poke <file> [file...]