Setting the file. One moment. Raw file
scripts/quick_validate.py
Python·95 lines·3 KB
=
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)