Skip to content

moonlight-lupin/agent-skills / plugins/skill-retrieval

skill-retrieval

Verified

BM25-based skill retrieval plugin for Hermes Agent. Replaces the full skill list in the system prompt with a names-only compact view (~2K tokens) and injects top-K relevant skill descriptions per turn via BM25 retrieval (~300 tokens). Saves ~9K tokens/turn. Use when system prompt token overhead from skills is a concern, or when skill discovery quality matters.

tests/test_profile_home_switch.py

View on GitHub
"""The corpus must follow Hermes' *current* home, not the one at import.

Hermes' get_hermes_home() honours a context-local per-profile override, so a
long-lived process can serve profile A and later profile B. The retriever
must resolve skill/config paths at call time and never mistake a profile
switch for a test override of its legacy path constants.
"""

import contextvars
import importlib
import sys
import types
from pathlib import Path

import pytest

import bm25_retriever as br


def _write_skill(root: Path, rel: str, name: str, description: str) -> None:
    skill_dir = root / rel
    skill_dir.mkdir(parents=True, exist_ok=True)
    (skill_dir / "SKILL.md").write_text(
        f'---\nname: {name}\ndescription: "{description}"\n---\n\n# {name}\n'
    )


def _make_home(home: Path, tag: str) -> Path:
    _write_skill(home / "skills", f"only-{tag}", f"only-{tag}", f"widget{tag} tool")
    _write_skill(home / "skills", f"f1-{tag}", f"f1-{tag}", "filler one")
    _write_skill(home / "skills", f"f2-{tag}", f"f2-{tag}", "filler two things")
    return home


@pytest.fixture
def hermes_home_override(monkeypatch, tmp_path):
    """Stub hermes_constants with a context-local home override, as Hermes
    has, and import bm25_retriever while profile A is active."""
    home_a = _make_home(tmp_path / "homeA", "A")
    home_b = _make_home(tmp_path / "homeB", "B")
    override = contextvars.ContextVar("hermes_home", default=None)
    hc = types.ModuleType("hermes_constants")
    hc.get_hermes_home = lambda: Path(override.get() or home_a)
    hc.get_config_path = lambda: hc.get_hermes_home() / "config.yaml"
    hc.get_skills_dir = lambda: hc.get_hermes_home() / "skills"
    monkeypatch.setitem(sys.modules, "hermes_constants", hc)
    # The standalone loader path needs "agent" to be UNIMPORTABLE, not just
    # absent: `from agent.prompt_builder import ...` resolves against
    # sys.modules['agent.prompt_builder'] directly, bypassing the None
    # sentinel on "agent". Neutralize the whole import family for this file.
    monkeypatch.setitem(sys.modules, "agent.prompt_builder", None)
    monkeypatch.setitem(sys.modules, "agent.skill_utils", None)
    importlib.reload(br)
    yield override, home_b
    monkeypatch.undo()
    importlib.reload(br)


def test_index_follows_home_switch_after_import(hermes_home_override, monkeypatch):
    override, home_b = hermes_home_override
    # No Hermes skill-discovery helpers: exercises the standalone loader.
    monkeypatch.setitem(sys.modules, "agent", None)
    override.set(str(home_b))  # a later turn runs under profile B

    index = br.get_index()
    assert index is not None
    assert [r[0] for r in index.retrieve("widgetB")] == ["only-B"]
    assert index.retrieve("widgetA") == []


def test_home_switch_uses_hermes_discovery(hermes_home_override, monkeypatch):
    """A profile switch must not divert away from Hermes' gated loader."""
    override, home_b = hermes_home_override
    pb = types.ModuleType("agent.prompt_builder")
    pb._current_session_platform_hint = lambda: ""
    pb.extract_skill_conditions = lambda fm: {}
    shown = []
    pb._skill_should_show = lambda *a: shown.append(a) or True
    pb._parse_skill_file = lambda f: (True, {"name": br._parse_skill_md(f)[0]}, br._parse_skill_md(f)[1])
    pb._build_snapshot_entry = lambda f, root, fm, desc: {
        "category": "general", "skill_name": f.parent.name,
        "frontmatter_name": fm["name"], "description": desc,
    }
    su = types.ModuleType("agent.skill_utils")
    su.get_disabled_skill_names = lambda platform=None: set()
    su.get_project_skills_dirs = lambda: []
    su.get_all_skills_dirs = lambda: [sys.modules["hermes_constants"].get_skills_dir()]
    su.iter_project_skill_files = lambda root: sorted(root.rglob("SKILL.md"))
    su.iter_skill_index_files = lambda root, filename: sorted(root.rglob(filename))
    monkeypatch.setitem(sys.modules, "agent", types.ModuleType("agent"))
    monkeypatch.setitem(sys.modules, "agent.prompt_builder", pb)
    monkeypatch.setitem(sys.modules, "agent.skill_utils", su)
    monkeypatch.setitem(sys.modules, "hermes_cli.plugins", None)
    override.set(str(home_b))

    index = br.get_index()
    assert index is not None
    assert [r[0] for r in index.retrieve("widgetB")] == ["only-B"]
    assert shown, "Hermes' _skill_should_show gate must run"
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall