From 890bd74ec6aedfccd272d64058db22eb0a2fb8e2 Mon Sep 17 00:00:00 2001
From: Scott Chacon <schacon@gmail.com>
Date: Wed, 4 Feb 2026 13:45:45 +0100
Subject: [PATCH] subcommand updates and skill update

---
 app/global.css                      | 16 +++++++----
 content/docs/commands/but-skill.mdx | 44 ++++++++++++++++++++---------
 content/docs/commands/meta.json     |  5 ++--
 3 files changed, 42 insertions(+), 23 deletions(-)

diff --git a/app/global.css b/app/global.css
index 741b058..4833aa2 100644
--- a/app/global.css
+++ b/app/global.css
@@ -83,15 +83,19 @@ p[class*="mb-8"][class*="text-lg"][class*="text-fd-muted-foreground"] {
 /* Make code in h3 headings smaller and highlighted */
 
 .prose h3 a {
-  font-size: 1.1em;
-  color: #266;
-  margin-top: 15px;
+  font-size: 1.3em;
+  font-weight: 700;
+  color: #1a4d4d;
+  margin-top: 20px;
 }
 
 .prose h3 a code {
-  font-size: 0.8em;
-  padding: 2px 6px;
-  color: #4c4f69;
+  font-size: 0.85em;
+  font-weight: 600;
+  padding: 3px 8px;
+  color: #2c3e50;
+  background-color: #e8f4f8;
+  border-radius: 4px;
 }
 
 
diff --git a/content/docs/commands/but-skill.mdx b/content/docs/commands/but-skill.mdx
index fdedf60..7082a79 100644
--- a/content/docs/commands/but-skill.mdx
+++ b/content/docs/commands/but-skill.mdx
@@ -31,28 +31,38 @@ but skill install --global
 
 Install the GitButler CLI skill files for Coding agents
 
-By default, installs the skill into the current repository. The command will prompt you to select a skill folder format (Claude Code, OpenCode, Codex, GitHub Copilot, Cursor, Windsurf) unless you specify a custom path with --path.
+By default, installs the skill into the current repository. The command
+will prompt you to select a skill folder format (Claude Code, OpenCode, Codex, GitHub Copilot,
+Cursor, Windsurf) unless you specify a custom path with --path.
 
-Use --global to install the skill in a global location instead of the current repository.
+Use --global to install the skill in a global location instead of the
+current repository.
 
-Examples
+## Examples
 
 Install in current repository (prompts for format):
 
-  but skill install
+```text
+but skill install
+```
 
 Install globally (prompts for format):
 
-  but skill install --global
+```text
+but skill install --global
+```
 
 Install to a custom path:
 
-  but skill install --path .claude/skills/gitbutler
+```text
+but skill install --path .claude/skills/gitbutler
+```
 
 Auto-detect installation location (update existing installation):
 
-  but skill install --detect
-
+```text
+but skill install --detect
+```
 
 **Usage:** `but skill install [OPTIONS]`
 
@@ -66,22 +76,28 @@ Auto-detect installation location (update existing installation):
 
 Check if installed GitButler skills are up to date with the CLI version
 
-Scans for installed skill files and compares their version with the current CLI version. By default, checks both local (repository) and global installations.
+Scans for installed skill files and compares their version with the current
+CLI version. By default, checks both local (repository) and global installations.
 
-Examples
+## Examples
 
 Check all installed skills:
 
-  but skill check
+```text
+but skill check
+```
 
 Check and automatically update outdated skills:
 
-  but skill check --update
+```text
+but skill check --update
+```
 
 Check only global installations:
 
-  but skill check --global
-
+```text
+but skill check --global
+```
 
 **Usage:** `but skill check [OPTIONS]`
 
diff --git a/content/docs/commands/meta.json b/content/docs/commands/meta.json
index acccdfe..050184e 100644
--- a/content/docs/commands/meta.json
+++ b/content/docs/commands/meta.json
@@ -31,6 +31,8 @@
     "but-uncommit",
     "but-amend",
     "but-squash",
+    "but-move",
+    "but-pick",
     "---Operations Log---",
     "but-oplog",
     "but-undo",
@@ -39,9 +41,6 @@
     "but-update",
     "but-alias",
     "but-config",
-    "---Miscellaneous---",
-    "but-move",
-    "but-pick",
     "but-skill"
   ]
 }