smartbiblia
CLI d'installation des skills et serveurs MCP smartbiblia dans un workspace agent (Claude Code, Claude Desktop, Codex, OpenClaw, Hermes…).
La CLI ne contient aucune copie des skills : elle lit le catalogue sur GitHub à chaque appel et télécharge le dossier demandé. Le package reste minuscule, et une skill corrigée est disponible sans republier la CLI.
Installation
Rien à installer de façon permanente — uvx
exécute directement depuis PyPI :
uvx smartbiblia list
Ou en outil global :
uv tool install smartbiblia
smartbiblia list
Ce que la CLI installe
| Type | Contenu | Destination par défaut |
|---|---|---|
skill |
SKILL.md, scripts/, prompts/, schemas/, references/ |
./skills/<nom-canonique>/ |
mcp |
mcp_server.py, Dockerfile, README.md |
./mcp/<nom-canonique>/ |
Alias et nom canonique. En ligne de commande on écrit l'alias court
(sudoc), mais l'installation crée le dossier sous le nom canonique
(search-records-sudoc). C'est délibéré : un runtime d'agent apparie le nom du
dossier et le champ name du frontmatter, et un dossier mal nommé peut ne pas
être chargé. Les deux formes sont acceptées en argument.
Commandes
Lister
smartbiblia list # skills et serveurs MCP
smartbiblia list --kind mcp # seulement les serveurs MCP
smartbiblia list --tag french
Consulter le détail
smartbiblia info sudoc
smartbiblia info primo # variables d'environnement, port, entrypoint
Installer
smartbiblia add sudoc # → ./skills/search-records-sudoc/
smartbiblia add openalex --claude # → ~/.claude/skills/search-works-openalex/
smartbiblia add sudoc --dest ./mon-projet/skills
smartbiblia add sudoc --force # écraser sans confirmation
smartbiblia add openalex --kind mcp # → ./mcp/openalex/
--kind n'est nécessaire que si un même nom existe des deux côtés. Sans
--force, une destination existante demande confirmation.
Mettre à jour, désinstaller
smartbiblia update sudoc
smartbiblia remove sudoc
update vide le dossier avant de le réécrire : un fichier supprimé en amont
(un vieux prompt, un schéma renommé) ne survit pas à la mise à jour et ne peut
donc pas être relu par l'agent.
Brancher un serveur MCP sur un client
smartbiblia mcp-config openalex # bloc stdio, script local
smartbiblia mcp-config openalex --transport http # bloc HTTP + commande de lancement
smartbiblia mcp-config sudoc-sru --remote # exécution depuis GitHub, sans installation
La sortie est un bloc mcpServers à coller dans la configuration du client
(Claude Desktop, Claude Code, Codex…). Les variables d'environnement attendues
sont pré-remplies à vide — la CLI n'écrit jamais de clé.
Vérifier la version et la source
smartbiblia version # version de la CLI et branche du catalogue lue
Variables d'environnement de la CLI
| Variable | Effet |
|---|---|
SMARTBIBLIA_GITHUB_TOKEN |
Jeton GitHub optionnel : relève la limite de 60 requêtes/heure de l'API anonyme |
SMARTBIBLIA_BRANCH |
Branche source du catalogue (défaut main) — utile pour tester une branche |
SMARTBIBLIA_GITHUB_ORG / SMARTBIBLIA_GITHUB_REPO |
Pointer la CLI sur un fork |
Configuration des skills installées
La plupart des skills fonctionnent sans configuration : les valeurs par défaut
sont dans cli.py. Quand un scripts/.env.example est présent, copiez-le en
scripts/.env et ajustez. Une clé d'API n'est requise que pour les skills qui
la déclarent — smartbiblia info <nom> le dit.
Voir aussi
Cette page documente les commandes ; le contenu du catalogue est décrit ailleurs.
| Document | Contenu |
|---|---|
../README.md |
Le dépôt, la liste des skills, les conventions communes (en) |
../mcp/README.md |
Les cinq serveurs MCP, leurs outils et leurs ports (en) |
../skills/<skill>/SKILL.md |
Ce que fait une skill, quand l'utiliser, ce qu'elle renvoie |
DEPLOYMENT.md |
Publier une nouvelle version de la CLI sur PyPI |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file smartbiblia-0.2.0.tar.gz.
File metadata
- Download URL: smartbiblia-0.2.0.tar.gz
- Upload date:
- Size: 14.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe632e80ead8c6e8c99736b52a7bfd594e9137778f966d071c4b77860f389b18
|
|
| MD5 |
449417081a6b3b4872b380e70474c485
|
|
| BLAKE2b-256 |
7b59e98d44d54e3ed80dec45df347051f0b643c89579a3d2e570dd23af7f4f01
|
File details
Details for the file smartbiblia-0.2.0-py3-none-any.whl.
File metadata
- Download URL: smartbiblia-0.2.0-py3-none-any.whl
- Upload date:
- Size: 12.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ff8cb484583838ec0eca2e2b6ed2e9da44ad6924aa604f43e9c4ff88633f2b3
|
|
| MD5 |
ec62d166a55650a2d8cfa34dd5aa6d5d
|
|
| BLAKE2b-256 |
6327325b5a4113b686dcc6d0e43bb544cc928d209c139cf45a4fca8fb63c2539
|
