FilesExpand file tree

main

/

validate-skills

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

executable file

·

80 lines (61 loc) · 2.28 KB

main

/

validate-skills

Copy path

Top

File metadata and controls

• Code
• Blame

executable file

·

80 lines (61 loc) · 2.28 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

#!/usr/bin/env python3

from __future__ import annotations

import re

import sys

from pathlib import Path

try:

import yaml

except ModuleNotFoundError:

print(

"PyYAML is required; run: python3 -m pip install -r requirements-dev.txt",

file=sys.stderr,

)

raise SystemExit(2)

class NoAliasSafeLoader(yaml.SafeLoader):

def compose_node(self, parent: object, index: object) -> yaml.Node:

if self.check_event(yaml.AliasEvent):

event = self.get_event()

raise yaml.YAMLError(f"YAML aliases are not allowed: {event.anchor}")

return super().compose_node(parent, index)

def load_frontmatter(text: str) -> tuple[dict[object, object] | None, str | None]:

if not text.startswith("---\n"):

return None, "missing YAML frontmatter"

close = re.search(r"^---[ \t]*$", text[4:], re.MULTILINE)

if close is None:

return None, "unterminated YAML frontmatter"

try:

data = yaml.load(text[4:4 + close.start()], Loader=NoAliasSafeLoader)

except yaml.YAMLError as error:

return None, f"invalid YAML: {error}"

if data is None:

data = {}

if not isinstance(data, dict):

return None, "YAML frontmatter must be a mapping"

return data, None

def main() -> int:

root = Path(__file__).resolve().parent.parent

skill_files = sorted((root / "skills").glob("*/SKILL.md"))

if not skill_files:

print("No skills/*/SKILL.md files found.", file=sys.stderr)

return 1

errors: list[str] = []

for path in skill_files:

rel = path.relative_to(root)

data, error = load_frontmatter(path.read_text(encoding="utf-8"))

if error is not None:

errors.append(f"{rel}: {error}")

continue

assert data is not None

name = data.get("name")

description = data.get("description")

if not isinstance(name, str) or not name.strip():

errors.append(f"{rel}: missing name")

if not isinstance(description, str) or not description.strip():

errors.append(f"{rel}: missing description")

if errors:

print("\n".join(errors), file=sys.stderr)

return 1

print(f"validated {len(skill_files)} skills")

return 0

if __name__ == "__main__":

raise SystemExit(main())