@compilr-dev/agents-coding-python 0.1.2 → 0.1.4

package/dist/skills/python-best-practices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-best-practices.d.ts","sourceRoot":"","sources":["../../src/skills/python-best-practices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,wBAAwB,qCAuEnC,CAAC"}
+{"version":3,"file":"python-best-practices.d.ts","sourceRoot":"","sources":["../../src/skills/python-best-practices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,wBAAwB,qCAkFnC,CAAC"}

package/dist/skills/python-best-practices.js

@@ -9,7 +9,18 @@ export const pythonBestPracticesSkill = defineSkill({
     description: "Python-specific coding guidance and analysis workflow",
     version: "1.0.0",
     tags: ["python", "best-practices", "analysis"],
-    prompt: `You are in Python analysis mode. Use these tools for comprehensive code understanding:
+    prompt: `You are in Python analysis mode. Use these tools for comprehensive code understanding.
+
+## When to Use
+- Reviewing Python code for style and best practices
+- Onboarding to a Python codebase
+- Learning Pythonic patterns and conventions
+- Code review focusing on Python idioms
+
+## When NOT to Use
+- Need detailed code health metrics → use python-code-health skill
+- Need to understand dependencies → use python-dependency-audit skill
+- Planning a refactor → use python-refactor-impact skill first
 
 ## Code Structure Analysis
 - **getFileStructure**: Get overview of classes, functions, imports, variables

package/dist/skills/python-code-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-code-health.d.ts","sourceRoot":"","sources":["../../src/skills/python-code-health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,qBAAqB,qCA0MhC,CAAC"}
+{"version":3,"file":"python-code-health.d.ts","sourceRoot":"","sources":["../../src/skills/python-code-health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,qBAAqB,qCAuNhC,CAAC"}

package/dist/skills/python-code-health.js

@@ -9,7 +9,20 @@ export const pythonCodeHealthSkill = defineSkill({
     description: "Comprehensive Python code quality and health analysis",
     version: "1.1.0",
     tags: ["python", "code-health", "quality", "analysis"],
-    prompt: `You are in Python code health analysis mode. Use these tools systematically:
+    prompt: `You are in Python code health analysis mode. Use these tools systematically.
+
+## When to Use
+- Conducting a code quality audit
+- Finding complexity hotspots before refactoring
+- Identifying dead code that can be removed
+- Detecting code duplication and anti-patterns
+- Preparing for a code review or tech debt assessment
+
+## When NOT to Use
+- Need security-focused review → use security-review skill
+- Want to understand code structure → use python-code-structure skill
+- Planning specific refactoring → use python-refactor-impact skill first
+- Checking pip package vulnerabilities → use dependency-management skill (from core)
 
 ## Health Check Workflow
 

package/dist/skills/python-code-structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-code-structure.d.ts","sourceRoot":"","sources":["../../src/skills/python-code-structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,wBAAwB,qCAoJnC,CAAC"}
+{"version":3,"file":"python-code-structure.d.ts","sourceRoot":"","sources":["../../src/skills/python-code-structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,wBAAwB,qCA+JnC,CAAC"}

package/dist/skills/python-code-structure.js

@@ -9,7 +9,18 @@ export const pythonCodeStructureSkill = defineSkill({
     description: "Analyze Python codebase structure and organization",
     version: "1.0.0",
     tags: ["python", "structure", "architecture", "analysis"],
-    prompt: `You are in Python code structure analysis mode. Use these tools systematically:
+    prompt: `You are in Python code structure analysis mode. Use these tools systematically.
+
+## When to Use
+- Onboarding to a new Python codebase
+- Understanding project organization and architecture
+- Before major refactoring
+- Documentation generation
+
+## When NOT to Use
+- Need code quality metrics → use python-code-health skill
+- Planning specific changes → use python-refactor-impact skill first
+- Need dependency analysis → use python-dependency-audit skill
 
 ## Structure Analysis Workflow
 

package/dist/skills/python-dependency-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-dependency-audit.d.ts","sourceRoot":"","sources":["../../src/skills/python-dependency-audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,0BAA0B,qCA+OrC,CAAC"}
+{"version":3,"file":"python-dependency-audit.d.ts","sourceRoot":"","sources":["../../src/skills/python-dependency-audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,0BAA0B,qCA0PrC,CAAC"}

package/dist/skills/python-dependency-audit.js

@@ -9,7 +9,18 @@ export const pythonDependencyAuditSkill = defineSkill({
     description: "Audit Python imports and dependencies for issues",
     version: "1.1.0",
     tags: ["python", "dependencies", "imports", "audit"],
-    prompt: `You are in Python dependency audit mode. Use these tools systematically:
+    prompt: `You are in Python dependency audit mode. Use these tools systematically.
+
+## When to Use
+- Investigating circular import issues
+- Auditing module coupling before refactoring
+- Understanding import relationships in a codebase
+- Identifying heavy or duplicate third-party dependencies
+
+## When NOT to Use
+- Just need to understand one file's structure → use python-code-structure skill
+- Looking for a specific function or class → use find_symbol_python directly
+- Checking pip package vulnerabilities → use dependency-management skill (from core)
 
 ## Dependency Audit Workflow
 

package/dist/skills/python-refactor-impact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-refactor-impact.d.ts","sourceRoot":"","sources":["../../src/skills/python-refactor-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,yBAAyB,qCAiOpC,CAAC"}
+{"version":3,"file":"python-refactor-impact.d.ts","sourceRoot":"","sources":["../../src/skills/python-refactor-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,yBAAyB,qCA4OpC,CAAC"}

package/dist/skills/python-refactor-impact.js

@@ -9,7 +9,18 @@ export const pythonRefactorImpactSkill = defineSkill({
     description: "Assess impact of Python code changes and refactoring",
     version: "1.1.0",
     tags: ["python", "refactoring", "impact", "analysis"],
-    prompt: `You are in Python refactor impact analysis mode. Use these tools systematically:
+    prompt: `You are in Python refactor impact analysis mode. Use these tools systematically.
+
+## When to Use
+- Planning to rename, move, or change a function/class
+- Assessing risk before modifying public API
+- Understanding what files will need updates
+- Creating a refactoring checklist
+
+## When NOT to Use
+- Just want to understand what a symbol does → use python-code-structure skill
+- Need to find where a symbol is used (not planning to change it) → use find_references_python directly
+- Checking class hierarchy without planning changes → use get_class_hierarchy_python directly
 
 ## Impact Analysis Workflow
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents-coding-python",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Python analysis tools for AI agents - AST-based code analysis using Tree-sitter",
   "type": "module",
   "main": "dist/index.js",
@@ -64,7 +64,7 @@
     "node": ">=18.0.0"
   },
   "peerDependencies": {
-    "@compilr-dev/agents": "^0.3.0"
+    "@compilr-dev/agents": "^0.3.1"
   },
   "dependencies": {
     "tree-sitter": "^0.22.4",
@@ -72,7 +72,7 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.30.1",
-    "@compilr-dev/agents": "^0.3.0",
+    "@compilr-dev/agents": "^0.3.1",
     "@eslint/js": "^9.39.1",
     "@types/node": "^24.10.1",
     "@vitest/coverage-v8": "^3.2.4",