1#!/usr/bin/env python3
 2"""
 3Quick validation script for skills - minimal version
 4"""
 5
 6import sys
 7import os
 8import re
 9import yaml
10from pathlib import Path
11
12def validate_skill(skill_path):
13    """Basic validation of a skill"""
14    skill_path = Path(skill_path)
15
16    # Check SKILL.md exists
17    skill_md = skill_path / 'SKILL.md'
18    if not skill_md.exists():
19        return False, "SKILL.md not found"
20
21    # Read and validate frontmatter
22    content = skill_md.read_text()
23    if not content.startswith('---'):
24        return False, "No YAML frontmatter found"
25
26    # Extract frontmatter
27    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
28    if not match:
29        return False, "Invalid frontmatter format"
30
31    frontmatter_text = match.group(1)
32
33    # Parse YAML frontmatter
34    try:
35        frontmatter = yaml.safe_load(frontmatter_text)
36        if not isinstance(frontmatter, dict):
37            return False, "Frontmatter must be a YAML dictionary"
38    except yaml.YAMLError as e:
39        return False, f"Invalid YAML in frontmatter: {e}"
40
41    # Define allowed properties
42    ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata'}
43
44    # Check for unexpected properties (excluding nested keys under metadata)
45    unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
46    if unexpected_keys:
47        return False, (
48            f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. "
49            f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}"
50        )
51
52    # Check required fields
53    if 'name' not in frontmatter:
54        return False, "Missing 'name' in frontmatter"
55    if 'description' not in frontmatter:
56        return False, "Missing 'description' in frontmatter"
57
58    # Extract name for validation
59    name = frontmatter.get('name', '')
60    if not isinstance(name, str):
61        return False, f"Name must be a string, got {type(name).__name__}"
62    name = name.strip()
63    if name:
64        # Check naming convention (hyphen-case: lowercase with hyphens)
65        if not re.match(r'^[a-z0-9-]+$', name):
66            return False, f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)"
67        if name.startswith('-') or name.endswith('-') or '--' in name:
68            return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
69        # Check name length (max 64 characters per spec)
70        if len(name) > 64:
71            return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters."
72
73    # Extract and validate description
74    description = frontmatter.get('description', '')
75    if not isinstance(description, str):
76        return False, f"Description must be a string, got {type(description).__name__}"
77    description = description.strip()
78    if description:
79        # Check for angle brackets
80        if '<' in description or '>' in description:
81            return False, "Description cannot contain angle brackets (< or >)"
82        # Check description length (max 1024 characters per spec)
83        if len(description) > 1024:
84            return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters."
85
86    return True, "Skill is valid!"
87
88if __name__ == "__main__":
89    if len(sys.argv) != 2:
90        print("Usage: python quick_validate.py <skill_directory>")
91        sys.exit(1)
92    
93    valid, message = validate_skill(sys.argv[1])
94    print(message)
95    sys.exit(0 if valid else 1)