Function run_skill_create

openkb/skill/creator.py:172–224

Compile a single skill from the KB's wiki. Returns the path to the produced skill directory. Raises ``RuntimeError`` if the agent finishes without writing ``SKILL.md``, or if the SDK hits its turn cap before the agent declares done.

(
    *,
    kb_dir: Path,
    skill_name: str,
    intent: str,
    model: str,
)

async def run_skill_create(
    *,
    kb_dir: Path,
    skill_name: str,
    intent: str,
    model: str,
) -> Path:
    """Compile a single skill from the KB's wiki.

    Returns the path to the produced skill directory. Raises
    ``RuntimeError`` if the agent finishes without writing ``SKILL.md``,
    or if the SDK hits its turn cap before the agent declares done.
    """
    wiki_root = str(kb_dir / "wiki")
    skill_root = skill_dir(kb_dir, skill_name)

    agent = build_skill_create_agent(
        wiki_root=wiki_root,
        skill_root=str(skill_root),
        skill_name=skill_name,
        intent=intent,
        model=model,
    )

    # Single user message kicks off the compile. The system prompt already
    # contains the intent — this just nudges the agent to start.
    seed = (
        f"Compile the skill '{skill_name}'. Follow the system prompt's "
        f"working method. Read the wiki, then write the skill files."
    )

    # Lazy import: keeps the top of this module independent of the SDK's
    # internal exception layout in case its export path moves.
    from agents.exceptions import MaxTurnsExceeded

    try:
        await Runner.run(agent, seed, max_turns=MAX_TURNS)
    except MaxTurnsExceeded as exc:
        raise RuntimeError(
            f"Skill compilation hit the {MAX_TURNS}-step cap before finishing. "
            f"The wiki may be too large for a single skill, or the intent may "
            f"be too broad. Try splitting into multiple skills with narrower "
            f"intents, or pass a smaller wiki subset."
        ) from exc

    if not (skill_root / "SKILL.md").exists():
        raise RuntimeError(
            f"Skill compilation finished but agent did not write SKILL.md "
            f"at {skill_root}. The skill is incomplete; check the wiki has "
            f"content related to your intent."
        )

    return skill_root