sickn33/agentic-awesome-skills / plugins/aasb-skill-author/skills/skill-creator
skill-creator
VerifiedCreate and review reusable skill drafts with bundled Python scaffolding, basic frontmatter validation and ZIP packaging helpers. Use for skill authoring and packaging; verify target-host requirements separately.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.1 KB |
| README.md | markdown | 2.2 KB |
| SKILL.md | skill md | 1.6 KB |
| references/detailed-guide.md | markdown | 3.7 KB |
| references/output-patterns.md | markdown | 1.8 KB |
| references/workflows.md | markdown | 818 B |
| scripts/init_skill.py | script | 11.7 KB |
| scripts/package_skill.py | script | 5.1 KB |
| scripts/quick_validate.py | script | 4.4 KB |
scripts/package_skill.py
View on GitHub#!/usr/bin/env python3
"""
Modified for the AAS catalog: corrected bundled workflow, validation and packaging safeguards (2026-10-23).
Skill Packager - Creates a .skill ZIP; host compatibility is not guaranteed
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 sys
import zipfile
import tempfile
from pathlib import Path
def safe_user_path(path_value, base_dir="."):
"""Resolve a CLI path under the current workspace."""
if base_dir != ".":
raise ValueError("Custom base directories are not supported for CLI paths")
base_path = Path.cwd().resolve()
resolved_path = Path(path_value).expanduser().resolve()
try:
resolved_path.relative_to(base_path)
except ValueError as exc:
raise ValueError(f"Path escapes allowed directory: {path_value}") from exc
return resolved_path
from quick_validate import validate_skill
def should_include(file_path: Path, skill_path: Path) -> bool:
relative = file_path.relative_to(skill_path)
if any(part in {".git", ".venv", "venv", "node_modules", "__pycache__", ".pytest_cache"} for part in relative.parts):
return False
if file_path.name == ".env" or file_path.name.startswith(".env.") or file_path.suffix.lower() in {".pem", ".key", ".pyc", ".skill"}:
return False
if file_path.is_symlink():
return False
try:
file_path.resolve(strict=True).relative_to(skill_path.resolve(strict=True))
except (OSError, ValueError):
return False
return file_path.is_file()
def package_skill(skill_path, output_dir=None):
"""
Package a skill folder into a .skill file.
Args:
skill_path: Path to the skill folder
output_dir: Optional output directory for the .skill file (defaults to current directory)
Returns:
Path to the created .skill file, or None if error
"""
skill_path = safe_user_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 = safe_user_path(output_dir).resolve()
output_path.mkdir(parents=True, exist_ok=True)
else:
output_path = Path.cwd()
if output_path == skill_path or skill_path in output_path.parents:
raise ValueError("Archive output must be outside the skill directory")
skill_filename = output_path / f"{skill_name}.skill"
if skill_filename.exists() or skill_filename.is_symlink():
raise FileExistsError(f"Refusing to overwrite archive: {skill_filename}")
# Create the .skill file (zip format)
try:
with tempfile.TemporaryDirectory() as temp_dir:
temp_zip_path = Path(temp_dir) / "skill.zip"
with zipfile.ZipFile(temp_zip_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
# Walk through the skill directory
for file_path in skill_path.rglob('*'):
if should_include(file_path, skill_path):
# Calculate the relative path within the zip
arcname = file_path.relative_to(skill_path.parent)
zipf.write(file_path, arcname)
print(f" Added: {arcname}")
with skill_filename.open("xb") as output, temp_zip_path.open("rb") as source:
import shutil
shutil.copyfileobj(source, output)
print(f"\nβ
Successfully packaged skill to: {skill_filename}")
return skill_filename
except Exception as e:
print(f"β Error creating .skill 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 = safe_user_path(sys.argv[1])
output_dir = safe_user_path(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()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |