Add docstrings to explain skills system to OI

OI tries to call help(computer.skills.import_skills) or
help(computer.skills.list), for instance and there is no documentation.

Author: endolith

interpreter/core/computer/skills/skills.py

@@ -21,26 +21,54 @@
 
 
 class Skills:
+    """
+    Manages access to pre-imported automation skills.
+
+    Available methods:
+    - list(): Returns names of available skills
+    - search(query): Lists available skills (currently same as list())
+
+    Usage:
+    To use a skill, call it directly as a function:
+        example_skill()
+
+    To create a new skill:
+        computer.skills.new_skill.create()
+    """
     def __init__(self, computer):
         self.computer = computer
         self.path = str(Path(oi_dir) / "skills")
         self.new_skill = NewSkill(self)
 
     def list(self):
+        """
+        Lists all available skills. Skills are already imported and can be called directly.
+
+        Returns:
+            list[str]: Names of available skills with () to indicate they're callable
+        """
         return [
             file.replace(".py", "()")
             for file in os.listdir(self.path)
             if file.endswith(".py")
         ]
 
     def run(self, skill):
+        """
+        DEPRECATED: Do not use this method.
+        Skills are already imported - call them directly as functions instead.
+        """
         print(
             "To run a skill, run its name as a function name (it is already imported)."
         )
 
     def search(self, query):
         """
-        This just lists all for now.
+        Lists available skills (currently same as list()).
+        Skills are already imported and can be called directly.
+
+        Returns:
+            list[str]: Names of available skills with () to indicate they're callable
         """
         return [
             file.replace(".py", "()")
@@ -49,6 +77,13 @@ def search(self, query):
         ]
 
     def import_skills(self):
+        """
+        [INTERNAL METHOD - NOT FOR Assistant USE]
+        System initialization method that imports all Python files from the skills directory.
+
+        This method is called automatically during system setup to load available skills.
+        Assistant should use list(), search(), or call skills directly instead of this method.
+        """
         previous_save_skills_setting = self.computer.save_skills
 
         self.computer.save_skills = False