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.