Function _write_skill

tests/test_skill_validator.py:20–69

Create a skill directory with the requested contents. frontmatter: "default" -> a valid minimal frontmatter with matching name + long desc str -> use that exact frontmatter block (between --- markers) None -> write the body with NO frontmatter at all

(
    parent: Path,
    name: str,
    *,
    frontmatter: str | None = "default",
    body: str = "# body\n",
    refs: dict[str, str] | None = None,
    scripts: dict[str, str] | None = None,
    skill_md_bytes: int | None = None,
)

def _write_skill(
    parent: Path,
    name: str,
    *,
    frontmatter: str | None = "default",
    body: str = "# body\n",
    refs: dict[str, str] | None = None,
    scripts: dict[str, str] | None = None,
    skill_md_bytes: int | None = None,
) -> Path:
    """Create a skill directory with the requested contents.

    frontmatter:
      "default" -> a valid minimal frontmatter with matching name + long desc
      str       -> use that exact frontmatter block (between --- markers)
      None      -> write the body with NO frontmatter at all
    """
    skill_dir = parent / name
    skill_dir.mkdir(parents=True, exist_ok=True)
    if frontmatter == "default":
        fm = f"name: {name}\ndescription: A useful and descriptive skill activation signal."
    else:
        fm = frontmatter

    if fm is None:
        text = body
    else:
        text = f"---\n{fm}\n---\n\n{body}"

    if skill_md_bytes is not None:
        text = text + ("x" * skill_md_bytes)
    (skill_dir / "SKILL.md").write_text(text, encoding="utf-8")

    if refs:
        refs_dir = skill_dir / "references"
        refs_dir.mkdir(exist_ok=True)
        for relpath, content in refs.items():
            target = refs_dir / relpath
            target.parent.mkdir(parents=True, exist_ok=True)
            target.write_text(content, encoding="utf-8")

    if scripts:
        scripts_dir = skill_dir / "scripts"
        scripts_dir.mkdir(exist_ok=True)
        for relpath, content in scripts.items():
            target = scripts_dir / relpath
            target.parent.mkdir(parents=True, exist_ok=True)
            target.write_text(content, encoding="utf-8")

    return skill_dir


# ---------------------------------------------------------------------------