Expand 39 api-reference stubs with real tool docs, expand 15 agent.py boilerplate stubs

skills/exploiting-vulnerabilities-with-metasploit-framework/SKILL.md

@@ -13,6 +13,14 @@ license: Apache-2.0
 ## Overview
 The Metasploit Framework is the world's most widely used penetration testing platform, maintained by Rapid7. It contains over 2,300 exploits, 1,200 auxiliary modules, and 400 post-exploitation modules. Within vulnerability management, Metasploit serves as a validation tool to confirm that identified vulnerabilities are actually exploitable, enabling risk-based prioritization and demonstrating real-world impact to stakeholders.
 
+
+## When to Use
+
+- When performing authorized security testing that involves exploiting vulnerabilities with metasploit framework
+- When analyzing malware samples or attack artifacts in a controlled environment
+- When conducting red team exercises or penetration testing engagements
+- When building detection capabilities based on offensive technique understanding
+
 ## Prerequisites
 - Metasploit Framework installed (Kali Linux or standalone)
 - PostgreSQL database for session/credential management