Funk-lab/hermes-skills/funk/rag-docs/SKILL.md

name	description	version	author	license	platforms	metadata
rag-docs	Interroge la documentation Funk via RAG pour répondre aux questions sur le cluster, les services, les configs et les procédures admin.	1.0.0	Funk Lab	MIT	linux	hermes tags rag documentation funk cluster recherche

Documentation RAG — Cluster Funk

Quand utiliser ce skill

Pour toute question sur :

• Procédures admin (comment faire X, commandes utiles)
• Configuration d'un service (dnsmasq, litellm, hermes, nftables, llama-server...)
• Architecture du cluster Funk
• Dépannage d'un composant (diagnostics, causes connues)
• Alertes et monitoring

Ne pas utiliser pour l'état en temps réel (logs live, métriques actuelles) — utiliser Terminal directement.

---

Commande

rag-query "ta question"

Interroge la base vectorielle Qdrant avec la question, retourne les passages de documentation les plus proches sémantiquement (score ≥ 0.60).

Options :

rag-query "question" --top 3    # limiter à 3 résultats (défaut: 5)

---

Pattern obligatoire

Étape 1 — Interroger la base RAG :

terminal: rag-query "comment relancer dnsmasq après un reboot ?"

Étape 2 — Utiliser le contexte retourné pour formuler la réponse, en citant la source :

D'après la documentation Funk (admin/infra/dnsmasq.md § Dépannage) :
sudo systemctl restart dnsmasq
...

---

Exemples

# Procédure de redémarrage d'un service
terminal: rag-query "comment redémarrer llama-server gpu ?"

# Dépannage
terminal: rag-query "dnsmasq failed après reboot causes"

# Configuration
terminal: rag-query "nftables règles firewall cluster pod cidr"

# Architecture
terminal: rag-query "hermes profils litellm modèles disponibles"

# Alertes
terminal: rag-query "GPUTemperatureCritical seuil alertmanager"

---

Interpréter les résultats

Chaque résultat indique :

• source : admin/ia/hermes.md § Configuration
• score : pertinence sémantique (0.60–1.00) — un score > 0.75 est très pertinent
• texte : extrait du document

Si le score est < 0.65 ou les résultats hors sujet : répondre depuis ta connaissance générale et le mentionner ("Je n'ai pas trouvé de documentation spécifique sur ce point").

---

Règles

• Toujours citer la source (admin/ia/hermes.md § section)
• Un seul appel rag-query suffit pour une question — ne pas enchaîner plusieurs requêtes
• Ne jamais inventer des commandes non trouvées dans les résultats RAG