docs: fix incorrect CLI command syntax (#8)

- Change 'capiscio version' to 'capiscio --version' (version is a flag, not command)
- Fix 'key gen --output' to 'key gen --out-priv/--out-pub' (correct flag names)
- Remove '(includes scores)' from JSON output description (clarification)

Author: beonde

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

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).

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

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
 ```