git404hub

what is skill-retriever fr?

chonsong/skill-retriever — explained in plain English

Analysis updated 2026-05-18

6HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

Skill Retriever is a Hermes Agent plugin that uses one LLM call per query to pick the 3-20 most relevant skills from a flat index, instead of a slow multi-call tree search.

vibe map

mindmap
  root((Skill Retriever))
    What it does
      Curates skill bundles
      Single LLM call per query
      Flat index pre-filter
      Confidence scoring
    Tech stack
      Python
      Hermes Agent
      OpenAI-compatible LLMs
    Use cases
      Fast skill selection
      Subagent dispatch
      Phase-sectioned planning
    Requirements
      Hermes Agent 0.18+
      Python 3.10+
      LLM endpoint access

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Speed up an AI agent's skill selection from hundreds of calls per query down to a single call.

VIBE 2

Automatically inject a curated, confidence-scored list of relevant skills into an agent's context.

VIBE 3

Split skill coverage across the phases of a longer multi-step agent plan.

VIBE 4

Log every skill selection decision to a JSONL file for auditing or debugging.

what's the stack?

PythonHermes Agent

how it stacks up fr

chonsong/skill-retrieverabderazak-py/retro-homepageacoyfellow/zero-cloudflare-hello
Stars666
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Hermes Agent v0.18+ and an OpenAI-compatible LLM endpoint configured before the plugin can curate skill bundles.

MIT license for the core project: use freely for any purpose, including commercial use, as long as you keep the copyright notice, bundled community skills may have their own licenses.

in plain english

Skill Retriever is a plugin for Hermes Agent, an AI agent framework, that helps the agent pick which skills to load for a given user request. Skills here are packaged bundles of instructions the agent can use, similar in idea to plugins, and a system with hundreds of them needs a fast way to figure out which handful actually apply to the task at hand. The README explains that an older approach walked a tree of skill categories using repeated calls to a language model, which could take roughly 243 calls per query and was too slow for real use. Skill Retriever instead builds a single flat index of all available skills once, ahead of time, then narrows that list down to the top fifty likely candidates, and finally makes just one language model call to pick the best three to twenty skills for the current query. Each selected skill comes back with a load priority marked as must, should, or consider, a confidence level of high, medium, or low, and a short reason explaining why it was chosen. That information gets written into the user's message as a hint block the agent can act on, and skills are then loaded with a call to skill_view. You install it with pip, and Skill Retriever registers itself as a Hermes plugin automatically without any extra plugin development. It hooks into several points in Hermes: a pre_llm_call hook that injects a curated bundle on every turn, a subagent dispatch hook for per-task bundles, and a planning phase hook for splitting skill coverage across phases of a longer plan. It also logs every skill selection to a JSONL file for later review. Skill Retriever needs Hermes Agent version 0.18 or newer, Python 3.10 or newer, roughly 50 megabytes for its flat index, and access to an OpenAI-compatible language model endpoint such as LongCat or OpenAI itself. The project's own code is released under the MIT license, though it notes that community-contributed skills bundled separately may carry their own licenses.

prompts (copy fr)

prompt 1
Install skill-retriever with pip and set it up as a Hermes Agent plugin.
prompt 2
Run skill-retriever compose on a sample query and explain the load priority and confidence fields it returns.
prompt 3
How does Skill Retriever's flat-index pre-filter reduce LLM calls compared to recursive tree search?
prompt 4
Configure skill-retriever to use a custom LLM model and API key via environment variables.
prompt 5
Explain how the pre_llm_call hook injects a curated skill bundle into every agent turn.

Frequently asked questions

what is skill-retriever fr?

Skill Retriever is a Hermes Agent plugin that uses one LLM call per query to pick the 3-20 most relevant skills from a flat index, instead of a slow multi-call tree search.

What language is skill-retriever written in?

Mainly HTML. The stack also includes Python, Hermes Agent.

What license does skill-retriever use?

MIT license for the core project: use freely for any purpose, including commercial use, as long as you keep the copyright notice, bundled community skills may have their own licenses.

How hard is skill-retriever to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is skill-retriever for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.