ooai_skills.direct

Generalized installer: download from GitHub and route to correct locations.

Handles all resource types: - skills (SKILL.md) → .claude/skills/, .agents/skills/, ~/.agents/skills/, ~/.claude/skills/ - commands (.md) → .claude/commands/ - agents (.md) → .claude/agents/, .agents/personas/ - rules (.md, .mdc, .cursorrules) → .claude/rules/, .agents/rules/, .cursor/rules/ - mcp configs (.json) → .mcp.json merge

Classes

InstallResult

Summary of what was installed.

Functions

install_from_github(repo, *[, ref, what, name_filter, ...])

Download from GitHub and install to local directories.

install_from_url(url, *[, what, console])

Install from a GitHub URL.

Module Contents

class ooai_skills.direct.InstallResult

Summary of what was installed.

skills: int = 0
commands: int = 0
agents: int = 0
rules: int = 0
files: list[str] = []
property total: int
Return type:

int

ooai_skills.direct.install_from_github(repo, *, ref='main', what='all', name_filter=None, settings, console=None)

Download from GitHub and install to local directories.

Parameters:

  • repo (str) – GitHub repo in ‘owner/name’ format.

  • ref (str) – Branch or tag.

  • what (str) – What to install — ‘all’, ‘skills’, ‘commands’, ‘agents’, ‘rules’.

  • name_filter (str | None) – If set, only install items matching this name.

  • settings (ooai_skills.settings.OoaiSkillsSettings) – Settings instance.

  • console (rich.console.Console | None) – Rich console.

Returns:

InstallResult with counts of what was installed.

Return type:

InstallResult

ooai_skills.direct.install_from_url(url, *, what='all', settings, console=None)

Install from a GitHub URL.

Supports: - https://github.com/owner/repo - https://github.com/owner/repo/tree/branch/path - owner/repo

Parameters:
Return type:

InstallResult