pack_skill.py

scripts/pack_skill.py

1. #!/usr/bin/env python3
2. """
3. Pack skills into installable .skill files.
5. Each skill lives unpacked in skills/<name>/ so it can be read and reviewed. A
6. .skill file is the same folder as a zip archive, with the folder itself as the
7. top-level entry (<name>/SKILL.md, <name>/scripts/..., ...), which is the layout
8. Claude expects when a skill is uploaded.
10. Usage:
11. python3 scripts/pack_skill.py # every skill -> dist/<name>.skill
12. python3 scripts/pack_skill.py sop-author # just the named skills
14. Refuses a folder with no SKILL.md, or whose frontmatter `name` does not match
15. the folder, because Claude keys an installed skill by that name.
16. """
18. from __future__ import annotations
20. import re
21. import sys
22. import zipfile
23. from fnmatch import fnmatch
24. from pathlib import Path
26. ROOT = Path(__file__).resolve().parent.parent
27. SKILLS = ROOT / "skills"
28. DIST = ROOT / "dist"
29. # Glob patterns matched against each part of a path inside the skill folder. A
30. # local .env or config.json holds a live webhook, so it must never be packed.
31. SKIP = {".DS_Store", "__pycache__", ".env", "config.json", "*.skill"}
34. def skipped(rel: Path) -> bool:
35. return any(fnmatch(part, pattern) for part in rel.parts for pattern in SKIP)
38. def frontmatter_name(skill_md: Path) -> str | None:
39. text = skill_md.read_text(encoding="utf-8")
40. m = re.match(r"---\n(.*?)\n---", text, re.S)
41. if not m:
42. return None
43. name = re.search(r"^name:\s*(\S+)\s*$", m.group(1), re.M)
44. return name.group(1).strip("'\"") if name else None
47. def pack(folder: Path) -> Path:
48. skill_md = folder / "SKILL.md"
49. if not skill_md.is_file():
50. raise SystemExit(f"{folder.name}: no SKILL.md")
51. declared = frontmatter_name(skill_md)
52. if declared != folder.name:
53. raise SystemExit(f"{folder.name}: frontmatter name is {declared!r}, expected {folder.name!r}")
55. DIST.mkdir(exist_ok=True)
56. out = DIST / f"{folder.name}.skill"
57. with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as z:
58. for path in sorted(folder.rglob("*")):
59. rel = path.relative_to(folder)
60. if path.is_dir() or skipped(rel):
61. continue
62. z.write(path, Path(folder.name) / rel)
63. return out
66. def main(argv: list[str]) -> None:
67. names = argv or sorted(p.name for p in SKILLS.iterdir() if p.is_dir())
68. for name in names:
69. folder = SKILLS / name
70. if not folder.is_dir():
71. raise SystemExit(f"No skill folder named {name!r} in {SKILLS}")
72. out = pack(folder)
73. print(f"{out.relative_to(ROOT)} ({out.stat().st_size:,} bytes)")
76. if __name__ == "__main__":
77. main(sys.argv[1:])