check_skill()

Check if installed skills are up to date.

Usage

Source

check_skill(
    *,
    package=None,
    global_=False,
    local=True,
    root=None,
    update=False,
    quiet=False
)

Scans for installed SKILL.md files and compares their version with the version bundled in the installed Python package.

Parameters

package: str | None = None

Python package name to check. If None, checks all detected skills.

global_: bool = False

Only check global (home directory) installations.

local: bool = True

Only check local (repository) installations.

root: Path | None = None

Project root directory. Defaults to the current working directory.

update: bool = False

Automatically update any outdated skills found.

quiet: bool = False

Suppress output messages.

Returns

list[dict]

Status entries: {"path": Path, "name": str, "installed_version": str, "package_version": str, "status": "current"|"outdated"|"unknown"}.