← Back to Skills Marketplace
944
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install osori
Description
Osori v1.6.1 — Local project registry & context loader with Telegram slash commands. Registry versioning + auto-migration + root filters + root management +...
Usage Guidance
This skill appears coherent for managing a local project registry. Before installing: 1) Inspect registry_lib.py and telegram-commands.sh (bundled) to confirm there are no unexpected network endpoints or secrets being sent; those files implement core behavior. 2) Be aware it will read/scan filesystem paths and write a registry under $HOME/.openclaw by default — if you want a different location set OSORI_REGISTRY first. 3) The 'gh' CLI and optional 'entire' CLI will operate with whatever credentials/config you already have for those tools (the skill does not request separate tokens but will invoke them), so ensure your gh/entire configs are trusted. 4) Run /doctor without --fix first to preview changes; backups (.bak/.broken) are created when modifications occur. If you want higher assurance, provide the full contents of registry_lib.py and telegram-commands.sh for a targeted review — absence of those would lower confidence.
Capability Analysis
Type: OpenClaw Skill
Name: osori
Version: 1.6.1
The OpenClaw AgentSkills bundle 'osori' contains shell injection vulnerabilities in `scripts/find_handler.py` and `scripts/switch_handler.py`. User-controlled input (project names) is directly embedded into `mdfind` and `find` commands using f-strings, without proper escaping. This allows an attacker to register a project with a crafted name (e.g., `foo" -exec /bin/sh -c "echo pwned`) and execute arbitrary commands on the host system when the `/find` or `/switch` commands are invoked. While this is a critical vulnerability, there is no evidence of intentional malicious behavior (e.g., data exfiltration, persistence, or backdoors) within the provided code, classifying it as 'suspicious' rather than 'malicious'.
Capability Assessment
Purpose & Capability
Name/description (local registry, search, switch, Telegram commands) match the actual files and required binaries. The skill legitimately needs python3, git and gh for JSON handling, repo detection and GitHub counts; optional 'entire' usage is documented and only required for /entire-* commands.
Instruction Scope
SKILL.md and scripts perform filesystem discovery (mdfind/find), read/write a registry file under $HOME/.openclaw by default, call 'gh' and optionally 'entire', and run project-local commands when switching. These are in-scope for a registry/context loader, but they do grant the skill the ability to scan arbitrary paths and execute CLIs in project directories — review expectations and ensure you trust those CLIs and your registry contents.
Install Mechanism
No remote download/install spec is present (instruction-only skill with bundled scripts). The package includes shell and Python scripts that will be executed locally; nothing is fetched from unknown URLs during install.
Credentials
The skill declares no required env vars but honors optional variables (OSORI_REGISTRY, OSORI_SEARCH_PATHS, OSORI_CACHE_FILE, OSORI_CACHE_TTL). It relies on existing gh/entire CLI config for network access (these use the user's credentials/config). This is expected, but be aware 'gh' uses your GitHub auth and 'entire' interacts with an external service — no additional unrelated secrets are requested by the skill itself.
Persistence & Privilege
Does not request always:true or global agent changes. It writes its own registry (default $HOME/.openclaw/osori.json), creates backups, and uses atomic replace/rollback — behavior is contained to its own files and documented. Allowing autonomous invocation is the platform default and not a specific additional privilege here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install osori - After installation, invoke the skill by name or use
/osori - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.6.1
v1.6.1 — Code quality release: inline Python extraction, gh_count consolidation, doctor plan-driven fix. 148 tests.
v1.1.0
Switch default language to English, keep Korean triggers
v1.0.0
Initial release: project registry, scan, add, switch, TDD tests
Metadata
Frequently Asked Questions
What is Osori?
Osori v1.6.1 — Local project registry & context loader with Telegram slash commands. Registry versioning + auto-migration + root filters + root management +... It is an AI Agent Skill for Claude Code / OpenClaw, with 944 downloads so far.
How do I install Osori?
Run "/install osori" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Osori free?
Yes, Osori is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Osori support?
Osori is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Osori?
It is built and maintained by oozoofrog (@oozoofrog); the current version is v1.6.1.
More Skills