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

skills/deobfuscating-powershell-obfuscated-malware/SKILL.md

@@ -14,6 +14,14 @@ license: Apache-2.0
 
 PowerShell is heavily abused by malware authors due to its deep Windows integration and powerful scripting capabilities. Obfuscation techniques include string concatenation, Base64 encoding, character substitution, Invoke-Expression layering, SecureString abuse, environment variable manipulation, and tick-mark insertion. Modern malware uses multiple obfuscation layers requiring iterative deobfuscation. Tools like PSDecode, PowerDecode, and PowerPeeler automate much of this process, while manual AST (Abstract Syntax Tree) analysis handles custom obfuscation. PowerPeeler achieves a 95% deobfuscation correctness rate using instruction-level dynamic analysis of expression-related AST nodes.
 
+
+## When to Use
+
+- When performing authorized security testing that involves deobfuscating powershell obfuscated malware
+- 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
 
 - Python 3.9+ with `base64`, `re`, `subprocess` modules