Updated example to match player-only, no-target limitation using a sudoskill and recommend consumeslot mechanic instead, added links.

skills/mechanics/removehelditem.md

 ## Description
 Removes the given amount from the casting player's held item. 
 
-> **This is a no-target mechanic, and the affected entity will always be the caster**
+> **This is a no-target mechanic, and the affected player will always be the caster**
+
+<details><summary>Easier Alternative:</summary>
+The [consumeslot](skills/mechanics/consumeslot) mechanic is likely an easier choice for most use-cases, since it can target entities directly and choose which slot to remove from.
+</details>
 
 ## Attributes
 | Attribute | Aliases   | Description                                                          | Default |
@@ -10,11 +14,22 @@ Removes the given amount from the casting player's held item.
 
 
 ## Examples
+As a skill that only targets the casting player, a mob may need to use a [sudoskill](skills/mechanics/sudoskill) to remove the player's item:
+```yaml
+munchy:
+  Type: PIG
+  Skills:
+  - SudoSkill{s=removeApple} @trigger ~onInteract
+```
+This will cause a player to cast the `removeApple` meta-skill when right-clicking the mob:
 ```yaml
-ExampleSkill:
+removeApple:
+  Conditions:
+  - holding{m=APPLE} true
   Skills:
-  - removeHeldItem{amount=1} @trigger
+  - removeHeldItem{amount=1}
 ```
+This example checks for if the player (now the caster) is holding an apple, and if so, remove 1 from their hand.
 
 
 ## Aliases