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

skills/building-role-mining-for-rbac-optimization/SKILL.md

@@ -15,6 +15,14 @@ license: Apache-2.0
 
 Role mining is the process of analyzing existing user-permission assignments to discover optimal roles for a Role-Based Access Control (RBAC) system. Organizations accumulate excessive permissions over time through job changes, project assignments, and ad-hoc access grants, leading to "role explosion" where thousands of granular roles exist with significant overlap. Role mining uses data analysis -- including clustering algorithms, formal concept analysis, and graph-based methods -- to consolidate permissions into a minimal set of roles that accurately represent business functions while enforcing least privilege.
 
+
+## When to Use
+
+- When deploying or configuring building role mining for rbac optimization capabilities in your environment
+- When establishing security controls aligned to compliance requirements
+- When building or improving security architecture for this domain
+- When conducting security assessments that require this implementation
+
 ## Prerequisites
 
 - Export of current user-permission assignments (CSV/database)