ooai_skills.cli

Attributes

Functions

cmd_init([project_dir, no_mcp, no_claude_md, no_agents_md])

Scaffold multi-agent directory structure (Claude Code, Deep Agents, Codex, Gemini, Cursor, Copilot).

cmd_create(name[, kind, target])

Create a new skill, command, agent, or rule from template.

cmd_status()

Show skill installation status across all targets.

cmd_install(source[, ref, what, name])

Install skills/commands/agents/rules directly from GitHub (no MinIO).

cmd_push_local(source_dir[, pack])

cmd_pull([all_, copy, target, no_extra, name, category])

Pull skills from MinIO registry to local directories.

cmd_mirror(sources_file)

cmd_mirror_curated([category, kinds])

cmd_cur_categories()

cmd_cur_list([category, kind, limit])

cmd_cur_export(out_path[, kinds, all_categories, category])

cmd_loc_list([root, limit])

cmd_loc_find(pattern[, root, limit])

cmd_loc_remove(name[, root, all_targets])

Remove a locally installed skill.

cmd_loc_info(name[, root])

cmd_loc_cat(name[, root, head])

cmd_mcp_serve()

Start the MCP server (stdio transport) for skill browsing tools.

cmd_remote_stats()

cmd_remote_search(pattern[, limit])

Search the remote MinIO registry for skills.

cmd_ingest_github_zip(repo[, ref, kind, github_token])

Ingest a GitHub repo by downloading its archive ZIP (no git).

cmd_ingest_curated_zips([category, kinds, ref, kind, ...])

Ingest curated repos by downloading GitHub archive ZIPs (no git).

Module Contents

ooai_skills.cli.app
ooai_skills.cli.cur
ooai_skills.cli.loc
ooai_skills.cli.cmd_init(project_dir=Path('.'), no_mcp=False, no_claude_md=False, no_agents_md=False)

Scaffold multi-agent directory structure (Claude Code, Deep Agents, Codex, Gemini, Cursor, Copilot).

Parameters:
  • project_dir (Annotated[pathlib.Path, typer.Argument(help='Project root to scaffold.')])

  • no_mcp (Annotated[bool, typer.Option('--no-mcp', help='Skip .mcp.json creation.')])

  • no_claude_md (Annotated[bool, typer.Option('--no-claude-md', help='Skip CLAUDE.md changes.')])

  • no_agents_md (Annotated[bool, typer.Option('--no-agents-md', help='Skip AGENTS.md creation.')])

Return type:

None

ooai_skills.cli.cmd_create(name, kind='skill', target='both')

Create a new skill, command, agent, or rule from template.

Parameters:
  • name (Annotated[str, typer.Argument(help='Name (lowercase, hyphens ok).')])

  • kind (Annotated[str, typer.Option('--kind', help='What to create: skill, command, agent, rule.')])

  • target (Annotated[str, typer.Option('--target', help='Where to create: claude, agents, or both.')])

Return type:

None

ooai_skills.cli.cmd_status()

Show skill installation status across all targets.

Return type:

None

ooai_skills.cli.cmd_install(source, ref='main', what='all', name=None)

Install skills/commands/agents/rules directly from GitHub (no MinIO).

Parameters:
  • source (Annotated[str, typer.Argument(help='GitHub repo (owner/repo) or URL.')])

  • ref (Annotated[str, typer.Option('--ref', help='Branch or tag.')])

  • what (Annotated[str, typer.Option('--what', help='What to install: all, skills, commands, agents, rules.')])

  • name (Annotated[str | None, typer.Option('--name', help='Only install items matching this name.')])

Return type:

None

ooai_skills.cli.cmd_push_local(source_dir, pack='manual')
Parameters:
  • source_dir (Annotated[pathlib.Path, typer.Argument()])

  • pack (Annotated[str, typer.Option('--pack')])

Return type:

None

ooai_skills.cli.cmd_pull(all_=True, copy=False, target=[], no_extra=False, name=None, category=None)

Pull skills from MinIO registry to local directories.

Parameters:
  • all_ (Annotated[bool, typer.Option('--all')])

  • copy (Annotated[bool, typer.Option('--copy')])

  • target (Annotated[list[pathlib.Path], typer.Option('--target', help='Additional output dirs (repeatable).')])

  • no_extra (Annotated[bool, typer.Option('--no-extra', help='Skip default extra targets (e.g. ~/.claude/skills).')])

  • name (Annotated[str | None, typer.Option('--name', help='Pull a single skill by name from registry.')])

  • category (Annotated[str | None, typer.Option('--category', help='Only pull skills from repos in this curated category.')])

Return type:

None

ooai_skills.cli.cmd_mirror(sources_file)
Parameters:

sources_file (Annotated[pathlib.Path, typer.Argument()])

Return type:

None

ooai_skills.cli.cmd_mirror_curated(category=[], kinds=['skills'])
Parameters:
  • category (Annotated[list[str], typer.Option('--category')])

  • kinds (Annotated[list[str], typer.Option('--kinds')])

Return type:

None

ooai_skills.cli.cmd_cur_categories()
Return type:

None

ooai_skills.cli.cmd_cur_list(category=None, kind=[], limit=200)
Parameters:
  • category (Annotated[str | None, typer.Option('--category')])

  • kind (Annotated[list[str], typer.Option('--kind')])

  • limit (Annotated[int, typer.Option('--limit')])

Return type:

None

ooai_skills.cli.cmd_cur_export(out_path, kinds=['skills'], all_categories=True, category=[])
Parameters:
  • out_path (Annotated[pathlib.Path, typer.Argument()])

  • kinds (Annotated[list[str], typer.Option('--kinds')])

  • all_categories (Annotated[bool, typer.Option('--all-categories')])

  • category (Annotated[list[str], typer.Option('--category')])

Return type:

None

ooai_skills.cli.cmd_loc_list(root=None, limit=200)
Parameters:
  • root (Annotated[pathlib.Path | None, typer.Option('--root')])

  • limit (Annotated[int, typer.Option('--limit')])

Return type:

None

ooai_skills.cli.cmd_loc_find(pattern, root=None, limit=50)
Parameters:
  • pattern (Annotated[str, typer.Argument()])

  • root (Annotated[pathlib.Path | None, typer.Option('--root')])

  • limit (Annotated[int, typer.Option('--limit')])

Return type:

None

ooai_skills.cli.cmd_loc_remove(name, root=None, all_targets=False)

Remove a locally installed skill.

Parameters:
  • name (Annotated[str, typer.Argument(help='Skill name or folder to remove.')])

  • root (Annotated[pathlib.Path | None, typer.Option('--root')])

  • all_targets (Annotated[bool, typer.Option('--all-targets', help='Also remove from extra targets (e.g. ~/.claude/skills).')])

Return type:

None

ooai_skills.cli.cmd_loc_info(name, root=None)
Parameters:
  • name (Annotated[str, typer.Argument()])

  • root (Annotated[pathlib.Path | None, typer.Option('--root')])

Return type:

None

ooai_skills.cli.cmd_loc_cat(name, root=None, head=120)
Parameters:
  • name (Annotated[str, typer.Argument()])

  • root (Annotated[pathlib.Path | None, typer.Option('--root')])

  • head (Annotated[int, typer.Option('--head')])

Return type:

None

ooai_skills.cli.cmd_mcp_serve()

Start the MCP server (stdio transport) for skill browsing tools.

Return type:

None

ooai_skills.cli.remote
ooai_skills.cli.cmd_remote_stats()
Return type:

None

Search the remote MinIO registry for skills.

Parameters:
  • pattern (Annotated[str, typer.Argument(help='Search pattern.')])

  • limit (Annotated[int, typer.Option('--limit')])

Return type:

None

ooai_skills.cli.cmd_ingest_github_zip(repo, ref=typer.Option('main', '--ref', help='Branch/tag name.'), kind=typer.Option('heads', '--kind', help="Archive kind: 'heads' or 'tags'."), github_token=typer.Option(None, '--github-token', help='Optional GitHub token.'))

Ingest a GitHub repo by downloading its archive ZIP (no git).

Parameters:
Return type:

None

ooai_skills.cli.cmd_ingest_curated_zips(category=typer.Option([], '--category', help='Category to include (repeatable).'), kinds=typer.Option(['skills'], '--kinds', help='Kinds to include (repeatable).'), ref=typer.Option('main', '--ref', help='Branch/tag for all repos.'), kind=typer.Option('heads', '--kind', help="Archive kind: 'heads' or 'tags'."), github_token=typer.Option(None, '--github-token', help='Optional GitHub token.'))

Ingest curated repos by downloading GitHub archive ZIPs (no git).

Parameters:
Return type:

None