Skill Create

{
  "$schema": "https://agentskills.io/schemas/manifest.v1.json",
  "manifestVersion": "1.0",
  "generatedAt": "2026-01-03T03:55:59.147373Z",
  "generator": "skill-manifest-generator/1.0.0",
  "skill": {
    "name": "skill-create",
    "version": "1.0.0"
  },
  "integrity": {
    "algorithm": "sha256",
    "hash": "d580282b9222fa342ce073b5bb18a8957cd5c57e3fe1af9f17305c087ba1c4b8"
  },
  "files": [
    {
      "path": "SKILL.md",
      "size": 2796,
      "sha256": "83d1f4803d5bfcc3e868ed6699c296b64e9c03f31da1ed027e94df1d2bb1aca3",
      "type": "manifest"
    },
    {
      "path": "scripts/create_skill.py",
      "size": 11814,
      "sha256": "f04cd4fa32ea010ab3741be28a5c1718dd810ebfcc03c81196d5b301d5e8c238",
      "type": "script"
    }
  ],
  "externalReferences": [],
  "structure": {
    "maxDepth": 1,
    "totalFiles": 2,
    "totalBytes": 14610,
    "folders": [
      "scripts"
    ]
  },
  "license": {
    "spdxId": "MIT"
  }
}


#!/usr/bin/env python3
"""
Skill Scaffolder

Creates new Agent Skills from templates with proper structure.

Usage:
    python scaffold_skill.py my-skill
    python scaffold_skill.py my-skill --template with-scripts
    python scaffold_skill.py my-skill --description "My awesome skill"
    python scaffold_skill.py --interactive
"""

import argparse
import os
import re
import sys
from datetime import datetime
from pathlib import Path
from textwrap import dedent
from typing import Optional


TEMPLATES = ["basic", "with-scripts", "with-assets"]
DEFAULT_LICENSE = "MIT"
DEFAULT_AUTHOR = ""


def validate_name(name: str) -> tuple[bool, Optional[str]]:
    """
    Validate skill name according to spec.

    Rules:
    - 1-64 characters
    - lowercase alphanumeric and hyphens only
    - must start with a letter
    - cannot end with hyphen
    - no consecutive hyphens
    """
    if not name or len(name) == 0:
        return False, "Name is required"

    if len(name) > 64:
        return False, f"Name exceeds 64 characters (got {len(name)})"

    if not re.match(r'^[a-z0-9-]+$', name):
        return False, "Name must be lowercase alphanumeric and hyphens only"

    if not re.match(r'^[a-z]', name):
        return False, "Name must start with a letter"

    if name.endswith("-"):
        return False, "Name cannot end with a hyphen"

    if "--" in name:
        return False, "Name cannot contain consecutive hyphens"

    return True, None


def generate_skill_md(
    name: str,
    description: str = "",
    version: str = "1.0.0",
    license_id: str = DEFAULT_LICENSE,
    author: str = DEFAULT_AUTHOR,
    tags: list[str] = None
) -> str:
    """Generate SKILL.md content with proper frontmatter."""
    if not description:
        description = f"A skill for {name.replace('-', ' ')}"

    if tags is None:
        tags = []

    # Build frontmatter
    frontmatter_lines = [
        "---",
        f"name: {name}",
        f"description: {description}",
        f"version: {version}",
        f"license: {license_id}",
    ]

    if author:
        frontmatter_lines.append(f'author: "{author}"')

    if tags:
        frontmatter_lines.append("tags:")
        for tag in tags:
            frontmatter_lines.append(f"  - {tag}")

    frontmatter_lines.append("---")

    frontmatter = "\n".join(frontmatter_lines)

    # Instructions template
    instructions = dedent(f'''
        ## Instructions

        Describe what this skill does and how an agent should use it.

        ### When to Use

        - Describe scenarios when this skill is helpful
        - List specific use cases

        ### How to Use

        Explain how to invoke the skill:

        ```
        Example prompt that triggers this skill
        ```

        ## Examples

        **Example 1:**
        ```
        User: [example user request]
        Agent: [example agent response]
        ```

        ## Limitations

        - List any limitations or constraints
        - Note required dependencies

        ## Dependencies

        - Python 3