Address feedback from review

Author: gziolo

docs/6.hooks.md

@@ -1,6 +1,6 @@
 # 6. Hooks
 
-The Abilities API provides WordPress action hooks that allow developers to monitor and respond to ability execution events. These hooks enable logging, debugging, analytics, and custom integrations.
+The Abilities API provides [WordPress Action Hooks](https://developer.wordpress.org/apis/hooks/) that allow developers to monitor and respond to ability execution events.
 
 ## Available Actions
 
@@ -48,32 +48,6 @@ do_action( 'after_execute_ability', $ability_name, $input, $result );
 - `$input` (`mixed`): The input data that was passed to the ability.
 - `$result` (`mixed`): The validated result returned by the ability's execution callback.
 
-## When Actions Fire
-
-**`before_execute_ability` fires when:**
-
-- ✅ Permission checks pass.
-- ✅ Input validation succeeds (if input schema is defined).
-- ✅ Just before the execution callback is called.
-
-**`before_execute_ability` does NOT fire when:**
-
-- ❌ Permission checks fail.
-- ❌ Input validation fails.
-
-**`after_execute_ability` fires when:**
-
-- ✅ The execution callback returns successfully (not a `WP_Error`).
-- ✅ Output validation passes (if output schema is defined).
-- ✅ The ability execution completes successfully.
-
-**`after_execute_ability` does NOT fire when:**
-
-- ❌ Permission checks fail.
-- ❌ Input validation fails.
-- ❌ The execution callback returns a `WP_Error`.
-- ❌ Output validation fails.
-
 ## Usage Examples
 
 **Basic Logging**