skillnet-ai 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

skillnet_ai/__init__.py

@@ -0,0 +1,23 @@
+"""
+SkillNet AI SDK
+~~~~~~~~~~~~~~~
+
+A client library for searching, downloading, creating and evaluating AI Agent Skills.
+"""
+
+from skillnet_ai.client import SkillNetClient
+from skillnet_ai.creator import SkillCreator
+from skillnet_ai.downloader import SkillDownloader
+from skillnet_ai.evaluator import SkillEvaluator, EvaluatorConfig
+from skillnet_ai.searcher import SkillNetSearcher
+from skillnet_ai.analyzer import SkillRelationshipAnalyzer
+
+__all__ = [
+    "SkillNetClient",
+    "SkillCreator",
+    "SkillDownloader",
+    "SkillEvaluator",
+    "EvaluatorConfig",
+    "SkillNetSearcher",
+    "SkillRelationshipAnalyzer"
+]

skillnet_ai/analyzer.py

@@ -0,0 +1,222 @@
+import os
+import json
+import logging
+import re
+from typing import List, Dict, Any, Optional
+
+from openai import OpenAI
+from skillnet_ai.prompts import (
+    RELATIONSHIP_ANALYSIS_SYSTEM_PROMPT,
+    RELATIONSHIP_ANALYSIS_USER_PROMPT_TEMPLATE
+)
+
+logger = logging.getLogger(__name__)
+
+class SkillRelationshipAnalyzer:
+    """
+    Analyzes a directory of skills to determine relationships between them.
+    
+    Relationships determined:
+    - similar_to: A and B are functionally similar and interchangeable.
+    - belong_to: A is a sub-task/part of B (B is the larger scope).
+    - compose_with: A and B are independent but often used together.
+    - depend_on: A requires B to execute (prerequisite).
+    """
+
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None, model: str = "gpt-4o"):
+        self.api_key = api_key or os.getenv("API_KEY")
+        self.base_url = base_url or os.getenv("BASE_URL") or "https://api.openai.com/v1"
+        self.model = model
+        
+        if not self.api_key:
+            raise ValueError("API Key is missing. Please provide it in init or set API_KEY environment variable.")
+            
+        self.client = OpenAI(api_key=self.api_key, base_url=self.base_url)
+
+    def analyze_local_skills(self, skills_dir: str, save_to_file: bool = True) -> List[Dict[str, Any]]:
+        """
+        Main entry point: Scans a directory for skills and maps their relationships.
+
+        Args:
+            skills_dir: Path to the directory containing skill folders.
+            save_to_file: Whether to save the result as 'relationships.json' in the dir.
+
+        Returns:
+            A list of relationship dictionaries:
+            [
+                {
+                    "source": "skill_a",
+                    "target": "skill_b",
+                    "type": "depend_on",
+                    "reason": "Skill A imports modules provided by Skill B"
+                },
+                ...
+            ]
+        """
+        logger.info(f"Starting relationship analysis in: {skills_dir}")
+        
+        if not os.path.exists(skills_dir):
+            raise FileNotFoundError(f"Directory not found: {skills_dir}")
+
+        # 1. Load Skill Metadata
+        skills_metadata = self._load_skills_metadata(skills_dir)
+        if len(skills_metadata) < 2:
+            logger.warning("Not enough skills found to analyze relationships (need at least 2).")
+            return []
+
+        logger.info(f"Found {len(skills_metadata)} skills. Analyzing potential connections...")
+
+        # 2. Analyze with LLM
+        relationships = self._generate_relationship_graph(skills_metadata)
+        
+        # 3. Save Results
+        if save_to_file and relationships:
+            output_path = os.path.join(skills_dir, "relationships.json")
+            try:
+                with open(output_path, 'w', encoding='utf-8') as f:
+                    json.dump(relationships, f, indent=2, ensure_ascii=False)
+                logger.info(f"Relationships saved to: {output_path}")
+            except IOError as e:
+                logger.error(f"Failed to save relationships file: {e}")
+
+        return relationships
+
+    def _load_skills_metadata(self, root_dir: str) -> List[Dict[str, str]]:
+        """
+        Walks the directory to extract 'name' and 'description' from SKILL.md or README.md.
+        """
+        skills = []
+        
+        # Assuming typical structure: root_dir/skill_name/SKILL.md
+        for entry in os.scandir(root_dir):
+            if entry.is_dir():
+                skill_path = entry.path
+                skill_name = entry.name
+                description = "No description provided."
+                
+                # Try to read SKILL.md
+                content_file = None
+                if os.path.exists(os.path.join(skill_path, "SKILL.md")):
+                    content_file = os.path.join(skill_path, "SKILL.md")
+                
+                if content_file:
+                    try:
+                        with open(content_file, 'r', encoding='utf-8') as f:
+                            raw_content = f.read()
+                            # Extract description from Frontmatter or first paragraph
+                            description = self._extract_description(raw_content)
+                    except Exception as e:
+                        logger.warning(f"Could not read content for {skill_name}: {e}")
+
+                skills.append({
+                    "name": skill_name,
+                    "description": description
+                })
+        
+        return skills
+
+    def _extract_description(self, content: str) -> str:
+        """Helper to parse description from markdown frontmatter or body."""
+        # 1. Try YAML Frontmatter
+        frontmatter_match = re.search(r'^---\n(.*?)\n---', content, re.DOTALL)
+        if frontmatter_match:
+            fm_text = frontmatter_match.group(1)
+            # Simple regex search for description: ... line
+            desc_match = re.search(r'description:\s*(.+)$', fm_text, re.MULTILINE)
+            if desc_match:
+                return desc_match.group(1).strip().strip('"').strip("'")
+        
+        # 2. Fallback: Use the first non-header text block
+        # Remove headers
+        clean_text = re.sub(r'#+\s.*', '', content)
+        # Remove code blocks
+        clean_text = re.sub(r'```.*?```', '', clean_text, flags=re.DOTALL)
+        lines = [line.strip() for line in clean_text.split('\n') if line.strip()]
+        
+        if lines:
+            return lines[0]
+            
+        return "No description available."
+    
+    def _extract_json_from_tags(self, content: str, tag_name: str) -> str:
+        """Helper to extract content between XML-style tags."""
+        start_tag = f"<{tag_name}>"
+        end_tag = f"</{tag_name}>"
+        
+        if start_tag in content and end_tag in content:
+            return content.split(start_tag)[1].split(end_tag)[0].strip()
+        
+        clean_content = content.replace("```json", "").replace("```", "").strip()
+        
+        return clean_content
+
+    def _generate_relationship_graph(self, skills: List[Dict]) -> List[Dict]:
+        """Calls LLM to infer edges between nodes."""
+        
+        skills_json = json.dumps(skills, indent=2)
+        
+        messages = [
+            {"role": "system", "content": RELATIONSHIP_ANALYSIS_SYSTEM_PROMPT},
+            {"role": "user", "content": RELATIONSHIP_ANALYSIS_USER_PROMPT_TEMPLATE.format(
+                skills_list=skills_json
+            )}
+        ]
+
+        try:
+            response = self.client.chat.completions.create(
+                model=self.model,
+                messages=messages,
+            )
+            content = response.choices[0].message.content
+
+            # 1. Extract JSON from tags
+            json_str = self._extract_json_from_tags(content, "Skill_Relationships")
+            
+            # 2. Parse JSON
+            parsed_data = json.loads(json_str)
+            
+            # 3. Extract edges
+            edges = []
+            if isinstance(parsed_data, list):
+                edges = parsed_data
+            elif isinstance(parsed_data, dict) and "relationships" in parsed_data:
+                edges = parsed_data["relationships"]
+            
+            # 4. Validate edges structure
+            valid_edges = []
+            valid_names = {s['name'] for s in skills}
+            
+            valid_types = {'similar_to', 'belong_to', 'compose_with', 'depend_on'}
+
+            for edge in edges:
+                # Basic type check
+                if not isinstance(edge, dict):
+                    continue
+                    
+                s_name = edge.get('source')
+                t_name = edge.get('target')
+                r_type = edge.get('type')
+                
+                # Validate names and type
+                if (s_name in valid_names and 
+                    t_name in valid_names and 
+                    r_type in valid_types and
+                    s_name != t_name):
+                    
+                    valid_edges.append({
+                        "source": s_name,
+                        "target": t_name,
+                        "type": r_type,
+                        "reason": edge.get("reason", "No reason provided")
+                    })
+                    
+            logger.info(f"Identified {len(valid_edges)} valid relationships.")
+            return valid_edges
+
+        except json.JSONDecodeError as e:
+            logger.error(f"Failed to parse JSON content: {e}")
+            logger.debug(f"Raw content was: {content}")
+            return []
+        except Exception as e:
+            logger.error(f"Failed to analyze relationships: {e}")
+            return []