orama-system

Resolves and loads the canonical orama-system skill from a verified repository path.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill orama-system-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orama-system
Source: https://github.com/diazMelgarejo/orama-system/tree/main/.agents/skills/orama-system
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill orama-system-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It locates the canonical orama-system skill repository without hardcoded paths, ensuring agents always load the authoritative SKILL.md instead of stale or duplicated copies. ## Core Features & Use Cases - Marker-Verified Resolution: Searches environment variables, the current git repository root, and sibling checkouts for bin/orama-system/SKILL.md before loading anything. - Read-Only Loading: Guarantees no fetching, pulling, installing, or modification happens as a side effect of skill activation. - Explicit Refresh Workflow: Provides a guarded git fetch/pull procedure for authorized maintenance that protects dirty worktrees and non-tracking branches. - Use Case: An agent in any workspace needs the orama-system 5-stage methodology; this wrapper finds the canonical checkout via ORAMA_SYSTEM_ROOT or a bounded sibling-directory search and loads it safely. ## Quick Start Ask the agent to apply the orama-system methodology to your task and it will resolve and load the canonical skill automatically.

Frequently Asked Questions about orama-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I load the orama-system skill in Claude Code?

The wrapper resolves the canonical repository automatically by checking ORAMA_SYSTEM_ROOT, the current git toplevel, and sibling directories for bin/orama-system/SKILL.md. Once found, it reads and follows that canonical SKILL.md.

How does the wrapper find the canonical skill repository?

It checks ORAMA_SYSTEM_ROOT and ORAMA_SYSTEM_PATH first, then the current git repository root, then a bounded depth-2 search of parent and grandparent directories for a sibling checkout containing bin/orama-system/SKILL.md.

What happens if the canonical orama-system repo is not found?

The wrapper reports the canonical skill as unavailable and only asks for its location if the task genuinely requires it. It never guesses or falls back to a different repository's copy.

Does loading the skill modify or update the repository?

No. Loading is strictly read-only and marker-verified. Git fetch and pull only happen during an explicitly authorized refresh, and the pull is skipped if the worktree is dirty or fast-forward is impossible.

How do I update the canonical orama-system repository safely?

Run the documented refresh flow: cd into bin/orama-system, git fetch origin --prune, check git status, then git pull --ff-only only if the worktree is clean and the branch tracks origin. Otherwise the drift is reported without overwriting local work.