@phuc1403/musketeer 0.8.0 → 0.10.0

package/template/.claude/skills/skill-creator/scripts/package_skill.py

@@ -1,143 +1,143 @@
-#!/usr/bin/env python3
-"""
-Skill Packager - Creates a distributable zip file of a skill folder
-
-Usage:
-    python utils/package_skill.py <path/to/skill-folder> [output-directory]
-
-Example:
-    python utils/package_skill.py skills/public/my-skill
-    python utils/package_skill.py skills/public/my-skill ./dist
-"""
-
-import fnmatch
-import sys
-import zipfile
-from pathlib import Path
-
-from encoding_utils import configure_utf8_console
-from quick_validate import validate_skill
-
-# Fix Windows console encoding for Unicode output (emojis, arrows)
-configure_utf8_console()
-
-# Exclusion patterns (from official Anthropic skill-creator)
-EXCLUDE_DIRS = {'__pycache__', 'node_modules', '.git', '.DS_Store'}
-EXCLUDE_GLOBS = {'*.pyc', '*.pyo', '.DS_Store', '*.egg-info'}
-ROOT_EXCLUDE_DIRS = {'evals'}  # Only excluded at skill root level
-
-
-def package_skill(skill_path, output_dir=None):
-    """
-    Package a skill folder into a zip file.
-
-    Args:
-        skill_path: Path to the skill folder
-        output_dir: Optional output directory for the zip file (defaults to current directory)
-
-    Returns:
-        Path to the created zip file, or None if error
-    """
-    skill_path = Path(skill_path).resolve()
-
-    # Validate skill folder exists
-    if not skill_path.exists():
-        print(f"❌ Error: Skill folder not found: {skill_path}")
-        return None
-
-    if not skill_path.is_dir():
-        print(f"❌ Error: Path is not a directory: {skill_path}")
-        return None
-
-    # Validate SKILL.md exists
-    skill_md = skill_path / "SKILL.md"
-    if not skill_md.exists():
-        print(f"❌ Error: SKILL.md not found in {skill_path}")
-        return None
-
-    # Run validation before packaging
-    print("🔍 Validating skill...")
-    valid, message = validate_skill(skill_path)
-    if not valid:
-        print(f"❌ Validation failed: {message}")
-        print("   Please fix the validation errors before packaging.")
-        return None
-    print(f"✅ {message}\n")
-
-    # Determine output location
-    skill_name = skill_path.name
-    if output_dir:
-        output_path = Path(output_dir).resolve()
-        output_path.mkdir(parents=True, exist_ok=True)
-    else:
-        output_path = Path.cwd()
-
-    zip_filename = output_path / f"{skill_name}.zip"
-
-    # Create the zip file
-    try:
-        with zipfile.ZipFile(zip_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
-            # Walk through the skill directory, excluding unwanted files
-            skipped = []
-            for file_path in skill_path.rglob('*'):
-                if file_path.is_file():
-                    rel = file_path.relative_to(skill_path)
-                    parts = rel.parts
-
-                    # Skip excluded directories
-                    if any(p in EXCLUDE_DIRS for p in parts):
-                        skipped.append(str(rel))
-                        continue
-
-                    # Skip root-only excluded dirs (e.g., evals/)
-                    if parts[0] in ROOT_EXCLUDE_DIRS:
-                        skipped.append(str(rel))
-                        continue
-
-                    # Skip excluded file patterns
-                    if any(fnmatch.fnmatch(file_path.name, g) for g in EXCLUDE_GLOBS):
-                        skipped.append(str(rel))
-                        continue
-
-                    arcname = file_path.relative_to(skill_path.parent)
-                    zipf.write(file_path, arcname)
-                    print(f"  Added: {arcname}")
-
-            if skipped:
-                print(f"\n  Skipped {len(skipped)} file(s): {', '.join(skipped[:5])}"
-                      + ("..." if len(skipped) > 5 else ""))
-
-        print(f"\n✅ Successfully packaged skill to: {zip_filename}")
-        return zip_filename
-
-    except Exception as e:
-        print(f"❌ Error creating zip file: {e}")
-        return None
-
-
-def main():
-    if len(sys.argv) < 2:
-        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
-        print("\nExample:")
-        print("  python utils/package_skill.py skills/public/my-skill")
-        print("  python utils/package_skill.py skills/public/my-skill ./dist")
-        sys.exit(1)
-
-    skill_path = sys.argv[1]
-    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
-
-    print(f"📦 Packaging skill: {skill_path}")
-    if output_dir:
-        print(f"   Output directory: {output_dir}")
-    print()
-
-    result = package_skill(skill_path, output_dir)
-
-    if result:
-        sys.exit(0)
-    else:
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""
+Skill Packager - Creates a distributable zip file of a skill folder
+
+Usage:
+    python utils/package_skill.py <path/to/skill-folder> [output-directory]
+
+Example:
+    python utils/package_skill.py skills/public/my-skill
+    python utils/package_skill.py skills/public/my-skill ./dist
+"""
+
+import fnmatch
+import sys
+import zipfile
+from pathlib import Path
+
+from encoding_utils import configure_utf8_console
+from quick_validate import validate_skill
+
+# Fix Windows console encoding for Unicode output (emojis, arrows)
+configure_utf8_console()
+
+# Exclusion patterns (from official Anthropic skill-creator)
+EXCLUDE_DIRS = {'__pycache__', 'node_modules', '.git', '.DS_Store'}
+EXCLUDE_GLOBS = {'*.pyc', '*.pyo', '.DS_Store', '*.egg-info'}
+ROOT_EXCLUDE_DIRS = {'evals'}  # Only excluded at skill root level
+
+
+def package_skill(skill_path, output_dir=None):
+    """
+    Package a skill folder into a zip file.
+
+    Args:
+        skill_path: Path to the skill folder
+        output_dir: Optional output directory for the zip file (defaults to current directory)
+
+    Returns:
+        Path to the created zip file, or None if error
+    """
+    skill_path = Path(skill_path).resolve()
+
+    # Validate skill folder exists
+    if not skill_path.exists():
+        print(f"❌ Error: Skill folder not found: {skill_path}")
+        return None
+
+    if not skill_path.is_dir():
+        print(f"❌ Error: Path is not a directory: {skill_path}")
+        return None
+
+    # Validate SKILL.md exists
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        print(f"❌ Error: SKILL.md not found in {skill_path}")
+        return None
+
+    # Run validation before packaging
+    print("🔍 Validating skill...")
+    valid, message = validate_skill(skill_path)
+    if not valid:
+        print(f"❌ Validation failed: {message}")
+        print("   Please fix the validation errors before packaging.")
+        return None
+    print(f"✅ {message}\n")
+
+    # Determine output location
+    skill_name = skill_path.name
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    zip_filename = output_path / f"{skill_name}.zip"
+
+    # Create the zip file
+    try:
+        with zipfile.ZipFile(zip_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            # Walk through the skill directory, excluding unwanted files
+            skipped = []
+            for file_path in skill_path.rglob('*'):
+                if file_path.is_file():
+                    rel = file_path.relative_to(skill_path)
+                    parts = rel.parts
+
+                    # Skip excluded directories
+                    if any(p in EXCLUDE_DIRS for p in parts):
+                        skipped.append(str(rel))
+                        continue
+
+                    # Skip root-only excluded dirs (e.g., evals/)
+                    if parts[0] in ROOT_EXCLUDE_DIRS:
+                        skipped.append(str(rel))
+                        continue
+
+                    # Skip excluded file patterns
+                    if any(fnmatch.fnmatch(file_path.name, g) for g in EXCLUDE_GLOBS):
+                        skipped.append(str(rel))
+                        continue
+
+                    arcname = file_path.relative_to(skill_path.parent)
+                    zipf.write(file_path, arcname)
+                    print(f"  Added: {arcname}")
+
+            if skipped:
+                print(f"\n  Skipped {len(skipped)} file(s): {', '.join(skipped[:5])}"
+                      + ("..." if len(skipped) > 5 else ""))
+
+        print(f"\n✅ Successfully packaged skill to: {zip_filename}")
+        return zip_filename
+
+    except Exception as e:
+        print(f"❌ Error creating zip file: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
+        print("\nExample:")
+        print("  python utils/package_skill.py skills/public/my-skill")
+        print("  python utils/package_skill.py skills/public/my-skill ./dist")
+        sys.exit(1)
+
+    skill_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 Packaging skill: {skill_path}")
+    if output_dir:
+        print(f"   Output directory: {output_dir}")
+    print()
+
+    result = package_skill(skill_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/skill-creator/scripts/quick_validate.py

@@ -1,110 +1,110 @@
-#!/usr/bin/env python3
-"""
-Quick validation script for skills - minimal version
-"""
-
-import sys
-import re
-from pathlib import Path
-
-from encoding_utils import configure_utf8_console, read_text_utf8
-
-# Fix Windows console encoding for Unicode output
-configure_utf8_console()
-
-def validate_skill(skill_path):
-    """Basic validation of a skill"""
-    skill_path = Path(skill_path)
-    
-    # Check SKILL.md exists
-    skill_md = skill_path / 'SKILL.md'
-    if not skill_md.exists():
-        return False, "SKILL.md not found"
-    
-    # Read and validate frontmatter
-    content = read_text_utf8(skill_md)
-    if not content.startswith('---'):
-        return False, "No YAML frontmatter found"
-    
-    # Extract frontmatter
-    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
-    if not match:
-        return False, "Invalid frontmatter format"
-    
-    frontmatter = match.group(1)
-    
-    # Check required fields
-    if 'name:' not in frontmatter:
-        return False, "Missing 'name' in frontmatter"
-    if 'description:' not in frontmatter:
-        return False, "Missing 'description' in frontmatter"
-    
-    # Extract name for validation
-    name_match = re.search(r'name:\s*(.+)', frontmatter)
-    if name_match:
-        name = name_match.group(1).strip().strip('"').strip("'")
-
-        # Support namespaced identifiers: ck:skill-name (single namespace segment)
-        if name.count(':') > 1:
-            return False, (
-                f"Name '{name}' is invalid. Use either 'skill-name' or "
-                "'namespace:skill-name' with a single colon."
-            )
-
-        namespace = None
-        skill_id = name
-        if ':' in name:
-            namespace, skill_id = name.split(':', 1)
-
-        id_pattern = r'^[a-z0-9-]+$'
-        if namespace and not re.match(id_pattern, namespace):
-            return False, (
-                f"Namespace '{namespace}' must be lowercase letters, digits, and hyphens only"
-            )
-
-        if not re.match(id_pattern, skill_id):
-            return False, (
-                f"Skill id '{skill_id}' must be lowercase letters, digits, and hyphens only"
-            )
-
-        for segment_name, segment in [("namespace", namespace), ("skill id", skill_id)]:
-            if segment and (segment.startswith('-') or segment.endswith('-') or '--' in segment):
-                return False, (
-                    f"{segment_name.capitalize()} '{segment}' cannot start/end with hyphen "
-                    "or contain consecutive hyphens"
-                )
-
-    # Validate name length (official max: 64 chars)
-    if name_match:
-        if len(skill_id) > 64:
-            return False, f"Skill id '{skill_id}' exceeds 64 characters ({len(skill_id)})"
-        if namespace and len(namespace) > 64:
-            return False, f"Namespace '{namespace}' exceeds 64 characters ({len(namespace)})"
-
-    # Extract and validate description
-    desc_match = re.search(r'description:\s*(.+)', frontmatter)
-    if desc_match:
-        description = desc_match.group(1).strip().strip('"').strip("'")
-
-        # YAML block scalar indicators are valid (e.g. description: >-)
-        if description in {'>', '>-', '|', '|-'}:
-            description = ''
-
-        # Check for angle brackets
-        if '<' in description or '>' in description:
-            return False, "Description cannot contain angle brackets (< or >)"
-
-        # Check description length (official max: 1024 chars)
-        if len(description) > 1024:
-            return False, f"Description exceeds 1024 characters ({len(description)})"
-
-    return True, "Skill is valid!"
-
-if __name__ == "__main__":
-    if len(sys.argv) != 2:
-        print("Usage: python quick_validate.py <skill_directory>")
-        sys.exit(1)
-    
-    valid, message = validate_skill(sys.argv[1])
-    print(message)
-    sys.exit(0 if valid else 1)
+#!/usr/bin/env python3
+"""
+Quick validation script for skills - minimal version
+"""
+
+import sys
+import re
+from pathlib import Path
+
+from encoding_utils import configure_utf8_console, read_text_utf8
+
+# Fix Windows console encoding for Unicode output
+configure_utf8_console()
+
+def validate_skill(skill_path):
+    """Basic validation of a skill"""
+    skill_path = Path(skill_path)
+    
+    # Check SKILL.md exists
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.md not found"
+    
+    # Read and validate frontmatter
+    content = read_text_utf8(skill_md)
+    if not content.startswith('---'):
+        return False, "No YAML frontmatter found"
+    
+    # Extract frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "Invalid frontmatter format"
+    
+    frontmatter = match.group(1)
+    
+    # Check required fields
+    if 'name:' not in frontmatter:
+        return False, "Missing 'name' in frontmatter"
+    if 'description:' not in frontmatter:
+        return False, "Missing 'description' in frontmatter"
+    
+    # Extract name for validation
+    name_match = re.search(r'name:\s*(.+)', frontmatter)
+    if name_match:
+        name = name_match.group(1).strip().strip('"').strip("'")
+
+        # Support namespaced identifiers: ck:skill-name (single namespace segment)
+        if name.count(':') > 1:
+            return False, (
+                f"Name '{name}' is invalid. Use either 'skill-name' or "
+                "'namespace:skill-name' with a single colon."
+            )
+
+        namespace = None
+        skill_id = name
+        if ':' in name:
+            namespace, skill_id = name.split(':', 1)
+
+        id_pattern = r'^[a-z0-9-]+$'
+        if namespace and not re.match(id_pattern, namespace):
+            return False, (
+                f"Namespace '{namespace}' must be lowercase letters, digits, and hyphens only"
+            )
+
+        if not re.match(id_pattern, skill_id):
+            return False, (
+                f"Skill id '{skill_id}' must be lowercase letters, digits, and hyphens only"
+            )
+
+        for segment_name, segment in [("namespace", namespace), ("skill id", skill_id)]:
+            if segment and (segment.startswith('-') or segment.endswith('-') or '--' in segment):
+                return False, (
+                    f"{segment_name.capitalize()} '{segment}' cannot start/end with hyphen "
+                    "or contain consecutive hyphens"
+                )
+
+    # Validate name length (official max: 64 chars)
+    if name_match:
+        if len(skill_id) > 64:
+            return False, f"Skill id '{skill_id}' exceeds 64 characters ({len(skill_id)})"
+        if namespace and len(namespace) > 64:
+            return False, f"Namespace '{namespace}' exceeds 64 characters ({len(namespace)})"
+
+    # Extract and validate description
+    desc_match = re.search(r'description:\s*(.+)', frontmatter)
+    if desc_match:
+        description = desc_match.group(1).strip().strip('"').strip("'")
+
+        # YAML block scalar indicators are valid (e.g. description: >-)
+        if description in {'>', '>-', '|', '|-'}:
+            description = ''
+
+        # Check for angle brackets
+        if '<' in description or '>' in description:
+            return False, "Description cannot contain angle brackets (< or >)"
+
+        # Check description length (official max: 1024 chars)
+        if len(description) > 1024:
+            return False, f"Description exceeds 1024 characters ({len(description)})"
+
+    return True, "Skill is valid!"
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+    
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)