rangex v1

Agent Skill * SKILL.md

rangex

*range le vrac en contexte pour agents de code

Une masse de docs hétéroclites jetés en vrac → une arborescence markdown rangée + un manifeste que ton agent lit en premier. Il charge la carte, pas tout le corpus. 

$ curl -fsSL https://rangex.kerliane.eu/install.sh | bash

Linux & macOS · Claude Code · Codex · OpenCode · pi · conversion 100 % locale

ou laisse ton agent le faire

› Installe la skill rangex sur cette machine : exécute curl -fsSL https://rangex.kerliane.eu/install.sh | bash, puis vérifie que les symlinks ~/.claude/skills/rangex et ~/.agents/skills/rangex pointent vers ~/.local/share/rangex. Confirme ensuite que la skill « rangex » est bien disponible.
▍ Démarrer Le pipeline → 
  _vrac/                          context/
  ├── deck-strategie.pptx        ├── AGENTS.md        # lu en premier
  ├── CR-comite-12.docx     →    ├── INDEX.md         # la carte
  ├── export-confluence.html     ├── INDEX.json       # + visu locale
  ├── budget-2026.xlsx           ├── decisions/
  ├── mail-arbitrage.eml         └── sources/
  └── repo-front/  (git)             ├── cadrage/  specs/
                                     └── cr/  refs/

Le truc malin

La carte, pas le corpus

Chaque source devient un markdown classé, avec un front matter et un résumé de 2-3 phrases. build_index.py agrège tout ça dans un INDEX.md + AGENTS.md à la racine.

L'agent lit la carte, repère le bon doc, puis fait un grep ciblé — il ne charge que le nécessaire. Le contexte reste léger, l'info se retrouve localement, sans appel externe.

Démarrer

Trois mouvements

1

Installer la skill

Pose les symlinks pour Claude Code + Codex/OpenCode/pi. Aucun venv à pré-installer.

$ curl -fsSL https://rangex.kerliane.eu/install.sh | bash
2

Déposer le vrac

Tout, à plat, dans _vrac/ — PPTX, docs, comptes-rendus, mails, exports Confluence/Figma, repos.

$ mkdir -p _vrac   # puis dépose tes fichiers dedans
3

Ranger

Demande à ton agent. La skill orchestre l'inventaire, la conversion, le classement, l'enrichissement et le manifeste.

› range le contexte projet

Le pipeline

Cinq étapes · mécanique + jugement

01 · script

inventory

Scan, hash, dédoublonnage, détection de repos — et scan de secrets.

02 · script

convert

MarkItDown + notes PPTX → un markdown par source. 100 % local, rien ne sort.

03 · agent

classement

L'agent classe chaque doc selon la taxonomie et le profil, et le renomme.

04 · agent

enrichissement

Front matter + résumé de 2-3 phrases — la seule chose qui alimente l'INDEX.

05 · script

build_index

Génère INDEX.md, AGENTS.md, INDEX.json et .gitignore.

+ humain

serve

Visu locale (127.0.0.1) : arborescence, recherche, graphe docs↔tags, lecteur markdown.

Compliance

Pensé pour les repos client

  • Conversion 100 % locale — MarkItDown sans llm_client, aucun appel externe.
  • Scan de secrets — clés privées, service accounts GCP, tokens, .env/.pem sont mis en quarantaine et jamais convertis.
  • _vrac/ et sources/ sont .gitignore par défaut — jamais poussés dans un repo public.
  • Idempotent : relancer ne re-convertit que les nouveaux fichiers (comparaison de hash).