Function skill_new

openkb/cli.py:2311–2423

Compile a new skill from this KB's wiki. NAME is a kebab-case slug used for the output directory and skill name. INTENT is a natural-language description of what this skill should do. Example: openkb skill new karpathy-thinking "Reason about transformers like Karpathy"

(ctx, name, intent, yes_flag)

)
@click.pass_context
def skill_new(ctx, name, intent, yes_flag):
    """Compile a new skill from this KB's wiki.

    NAME is a kebab-case slug used for the output directory and skill name.
    INTENT is a natural-language description of what this skill should do.

    Example:

      openkb skill new karpathy-thinking "Reason about transformers like Karpathy"
    """
    kb_dir = _find_kb_dir(ctx.obj.get("kb_dir_override"))
    if kb_dir is None:
        click.echo("No knowledge base found. Run `openkb init` first.", err=True)
        ctx.exit(1)

    err = _preflight_skill_new(kb_dir, name)
    if err:
        click.echo(f"[ERROR] {err}", err=True)
        ctx.exit(1)

    # Verify LLM key + load config BEFORE touching existing output. Any
    # failure here (missing API key, malformed config) must leave the old
    # skill directory intact — we can't replace it if we can't proceed.
    try:
        _setup_llm_key(kb_dir)
    except RuntimeError as exc:
        click.echo(f"[ERROR] {exc}", err=True)
        ctx.exit(1)
    config = load_config(kb_dir / ".openkb" / "config.yaml")
    model = config.get("model", DEFAULT_CONFIG["model"])

    # Overwrite handling (CLI-specific). Done AFTER key/config so a
    # missing key doesn't wipe the user's existing skill output.
    #
    # When overwriting, we don't destroy the old skill — we copy it
    # into <kb>/output/skills/<name>-workspace/iteration-N/ first, so
    # the user can roll back via `openkb skill rollback`. See
    # ``openkb/skill/workspace.py``.
    from openkb.skill import skill_dir
    from openkb.skill.workspace import save_iteration, write_diff

    target = skill_dir(kb_dir, name)
    saved_iteration: Path | None = None
    if target.exists():
        if yes_flag:
            saved_iteration = save_iteration(kb_dir, name)
            _clear_existing_skill_dir(kb_dir, name)
        elif sys.stdin.isatty():
            if not click.confirm(
                f"output/skills/{name}/ already exists. Overwrite?",
                default=False,
            ):
                click.echo("Aborted.")
                ctx.exit(1)
            saved_iteration = save_iteration(kb_dir, name)
            _clear_existing_skill_dir(kb_dir, name)
        else:
            click.echo(