docs: update documentation for v0.4.0 features and requirements

Author: yeasy

docs/README.md

@@ -11,6 +11,8 @@ Welcome to the ASK (Agent Skills Kit) documentation.
 | [Skill Sources](skill-sources.md) | Understanding and configuring skill sources |
 | [Skill Format](skill-format.md) | Creating skills with SKILL.md |
 | [Configuration](configuration.md) | ask.yaml and ask.lock configuration |
+| [Troubleshooting](troubleshooting.md) | Common issues and solutions |
+| [Architecture](architecture.md) | Internal design and structure |
 
 ## Getting Help
 

docs/commands.md

@@ -187,6 +187,51 @@ ask repo add my-org/skills
 
 Remove a skill source.
 
-```bash
 ask repo remove <name>
 ```
+
+---
+
+## Utilities
+
+### ask benchmark
+
+Run performance benchmarks to measure CLI speed.
+
+```bash
+ask benchmark
+```
+
+**What it does:**
+- Measures cold and hot search performance
+- Measures config load time
+- Helps diagnose performance issues
+
+---
+
+### ask completion
+
+Generate shell completion scripts.
+
+```bash
+ask completion [bash|zsh|fish|powershell]
+```
+
+---
+
+## Global Flags
+
+### --offline
+
+Run specific commands in offline mode.
+
+```bash
+ask skill search <keyword> --offline
+ask skill outdated --offline
+```
+
+**What it does:**
+- Disables all network requests
+- Forces usage of local cache for search
+- Skips remote checks for updates
+- Useful for air-gapped environments or low connectivity

docs/installation.md

@@ -5,7 +5,7 @@ This guide covers all methods of installing ASK on your system.
 ## Requirements
 
 - **Operating System**: macOS, Linux, or Windows
-- **Go** (optional): 1.21+ if building from source
+- **Go** (optional): 1.24+ if building from source
 
 ---