diff --git a/README.md b/README.md
index 390b8d1..7d16499 100644
--- a/README.md
+++ b/README.md
@@ -27,11 +27,11 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 # Validate an agent
 capiscio validate https://my-agent.example.com
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate https://my-agent.example.com --json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 ### Wrapper Utilities
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 1c3b3c9..09cbd1b 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -19,7 +19,7 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 capiscio validate ./agent-card.json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 For full command reference, see the [CapiscIO Core Documentation](../../capiscio-core/index.md).
diff --git a/docs/index.md b/docs/index.md
index b0281c3..c7a0e41 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -39,11 +39,11 @@ pip install capiscio
 # Validate an agent card
 capiscio validate ./agent-card.json
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate ./agent-card.json --json
 
 # Check core binary version
-capiscio version
+capiscio --version
 ```
 
 ## What This Package Does
diff --git a/docs/reference/commands.md b/docs/reference/commands.md
index 05b3341..a6bd412 100644
--- a/docs/reference/commands.md
+++ b/docs/reference/commands.md
@@ -39,8 +39,8 @@ capiscio validate ./agent-card.json --json
 capiscio validate https://agent.example.com --test-live
 
 # Check version of the core binary
-capiscio version
+capiscio --version
 
-# Generate a signing key
-capiscio key gen --output ./my-key.jwk
+# Generate a signing key pair
+capiscio key gen --out-priv ./private.jwk --out-pub ./public.jwk
 ```