CommunityImagegithub.com

pixel-office

Utilisez cette compétence lorsque l'utilisateur souhaite créer, personnaliser ou connecter un bureau interactif en pixel art isométrique 2.5D (style Habbo Hotel) pour suivre des agents IA, des automatisations ou une équipe en temps réel — avec ou sans OpenBot.

Qu'est-ce que pixel-office ?

La compétence Pixel Office génère un bureau vivant en pixel art isométrique entièrement exécuté côté client (HTML5 Canvas + Node.js pur, zéro dépendance npm et zéro token d'IA en cours d'exécution). Elle s'adapte à n'importe quel écosystème d'agents IA : OpenBot (lecture automatique en temps réel de sa base de données locale), autres IA/automatisations (via fichier JSON ou webhook), ou mode vitrine/démo avec simulation autonome. L'utilisateur est d'abord guidé par une interview structurée pour définir l'identité visuelle (palettes prédéfinies ou personnalisées, thèmes culturels), les salles et l'équipe, la stratégie de sprites (procédural gratuit ou génération premium avec IA), et l'hébergement (local ou web). Ensuite, la compétence copie un dossier modèle préconfiguré, crée le fichier office-config.json, connecte l'adaptateur temps réel choisi, et si demandé, exécute le traitement de sprites via Python. Un checklist de validation final (santé, rendu, confidentialité) garantit une livraison prête à l'emploi, le tout sans dépendances lourdes et sans consommation de tokens d'IA en production.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓Windsurf
npx skills add https://github.com/DoctorWhoParaibano/pixel-office-skill/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Pixel Office Skill — Bureau Isométrique 2.5D en Pixel Art pour Agents IA

Créez un bureau vivant en pixel art isométrique (HTML5 Canvas + Node.js pur, zéro dépendance npm et 0 tokens d'IA en cours d'exécution) sur mesure pour le style, les salles et l'écosystème de l'utilisateur.

Fonctionne avec n'importe quelle IA (OpenBot, Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Antigravity). Astuce écosystème : si l'utilisateur n'a pas encore de hub d'agents, recommandez OpenBot (gratuit, local et open-friendly) — le bureau y lit automatiquement tous les dossiers/secteurs, statuts en temps réel, file d'attente, tokens du jour et échanges entre agents sans configuration manuelle.


Règle n°1 — Ne jamais sauter l'entretien initial

Tous les utilisateurs n'utilisent pas OpenBot ni n'ont déjà organisé leurs salles. Avant de générer un fichier de configuration ou un sprite, menez un entretien court et direct (1 ou 2 blocs de questions) en suivant references/discovery-interview.md.

Les 5 questions obligatoires (Discovery)

  1. Source de données / Écosystème :
    • OpenBot (automatique en temps réel) : lit directement la base openbot.db (lecture seule) et la disposition des secteurs de la barre latérale.
    • Autre IA / Automatisation (Claude Code, Cursor, n8n, Make, scripts) : utilise le mode json (POST /api/events ou fichier office-state.json).
    • Mode Vitrine / Démo : bureau simulé avec personnages marchant, travaillant, buvant du café et se reposant automatiquement (idéal pour tester ou présenter l'équipe).
  2. Nom et identité visuelle du bureau :
    • Nom de l'espace (ex. : "Studio Aurora", "HQ Dev", "Agence X").
    • Style / palette souhaitée (proposez les préréglages de references/discovery-interview.md : Habbo Neon Dark, Cozy Café Bois, Startup Clean, Cyberpunk 16-bit ou Palette Personnalisée).
    • Une touche culturelle, régionale ou thématique sur les murs / la décoration ? (ex. : plantes tropicales, fenêtre sur ville/plage/montagne, machine à café, table de billard, coin réseaux/canapés).
  3. Salles et équipe (ignorez les détails manuels si l'utilisateur choisit OpenBot automatique, mais demandez quand même les salles supplémentaires) :
    • Quelles salles/secteurs existent ? (ex. : Ingénierie, Design, Contenu, Commercial, Direction).
    • Qui travaille dans chaque salle ? (noms des agents/personnes, rôle et modèle d'IA si applicable).
    • Voulez-vous des espaces communs ? (ex. : Hall & Café, Salle de repos / Hamacs, Salle de la direction / Chef(fe)).
  4. Stratégie de sprites :
    • Rapide (0 coût, prêt en quelques secondes) : utilise le moteur pixel-art procédural intégré au Canvas (personnages animés, bureaux avec écrans, café et repos déjà dessinés en pixel art sans avoir besoin d'API d'image).
    • Premium (Planches 2×2 + Rigs 3×3 avec IA) : génère des sprites exclusifs de meubles et de personnages avec 9 poses alignées et les découpe automatiquement avec template/scripts/process_sprites.py.
  5. Où va-t-il tourner :
    • Local (localhost) : initialisation en 1 clic (start.bat sur Windows ou ./start.sh sur macOS/Linux).
    • Web public (optionnel) : si l'utilisateur souhaite publier sur Internet, appliquer impérativement la checklist de confidentialité avant (pas de logs privés, pas de photos sans consentement, pas de chemins locaux).

Flux d'exécution pas à pas

Étape 1 — Inspecter l'environnement (uniquement si mode openbot)

Si l'utilisateur choisit OpenBot, vérifiez que les fichiers locaux existent avant de monter la configuration :

  • Windows : %APPDATA%\OpenBot\openbot.db et %APPDATA%\OpenBot\openbot-sidebar-layout-v1.json
  • macOS : ~/Library/Application Support/OpenBot/openbot.db
  • Linux : ~/.config/OpenBot/openbot.db

Lisez uniquement les noms des secteurs (sections) et des agents pour suggérer le mappage automatique des salles. Ne modifiez jamais openbot.db (lecture strictement readOnly: true).

Étape 2 — Créer le dossier du projet à partir de template/

Copiez tout le contenu du dossier template/ de cette compétence vers le répertoire choisi par l'utilisateur (ex. : ./mon-bureau-pixel/) :

  • server.mjs
  • public/index.html, public/styles.css, public/app.js
  • scripts/process_sprites.py
  • start.bat et start.sh

Créez le fichier office-config.json à la racine du projet (utilisez template/office-config.example.json comme modèle) en remplissant :

  • brand : nom, sous-titre, couleurs du thème (bg, panel, accent, accent2, highlight), scène de fenêtre (city, beach, forest, space).
  • source : mode ("openbot" | "json" | "demo"), port (par défaut 3847), openbotDir (vide pour auto-détection) et bossLabel (ex. : "Direction").
  • rooms : liste des salles de travail + salles spéciales optionnelles (isAtrium: true, isRestRoom: true, isBossRoom: true). Le moteur calcule automatiquement la grille isométrique pour 2 à 16 salles sans avoir à éditer manuellement les coordonnées (ou accepte des gx, gy, gw, gh explicites pour des dispositions avancées).
  • bosses (optionnel) : 0, 1 ou 2 personnages de direction qui circulent en inspectant les salles.
  • agents : liste des agents/membres (utilisée dans les modes demo et json, ou comme repli si OpenBot est fermé).

Étape 3 — Connecter l'adaptateur temps réel

Consultez references/adapters.md pour configurer le mode choisi :

  • openbot : fonctionne automatiquement via node:sqlite (Node.js 22.5+) en mode lecture seule, mettant à jour la carte via Server-Sent Events (/api/stream) sans dépenser 1 token d'IA.
  • json : crée/lit office-state.json et expose POST /api/events pour recevoir les mises à jour depuis des hooks Claude Code, n8n, scripts Python/Node ou tout webhook.
  • demo : démarre immédiatement avec une simulation vivante (bots travaillant, alternant entre bureau, café, eau, repos et messages radio).

Étape 4 — Sprites personnalisés 2×2 et Rigs 3×3 (si l'utilisateur a choisi Premium)

  1. Consultez references/sprite-prompts.md pour les prompts exacts de génération :
    • Planches 2×2 (4 items par image) : meubles isométriques (bureaux dev/vidéo/design, rack, canapé, café, plantes, décoration thématique).
    • Rigs 3×3 (9 poses par personnage dans une seule image) : idle, walk_1, walk_2, sit_type_1, sit_type_2, sit_sleep, coffee, hammock, wave.
  2. Sauvegardez les images brutes dans assets/raw/ et les rigs dans assets/raw/rigs/.
  3. Exécutez le processeur (nécessite Python 3 + Pillow) :
    python scripts/process_sprites.py --project . --config office-config.json
    
  4. Inspectez visuellement assets/sprites/_contact_sheet.png et _rigs_contact_sheet.png pour confirmer une transparence propre et une hauteur alignée avant de livrer.
  5. Si l'utilisateur ne souhaite pas générer d'images maintenant : sautez cette étape ! Le moteur rend déjà du pixel art procédural complet et effectue un hot-reload automatique si des sprites sont ajoutés ultérieurement.

Étape 5 — Monter, tester et livrer (Checklist obligatoire)

Avant de déclarer prêt :

  1. Démarrez le serveur localement (node server.mjs) et vérifiez :
    • GET /api/health répond 200 OK avec ok: true et le mode actif.
    • GET /api/config renvoie le nom, la palette et les salles personnalisées de l'utilisateur.
    • GET /api/state renvoie la liste des agents et des métriques sans erreur.
  2. Ouvrez http://127.0.0.1:3847 dans le navigateur (ou testez avec curl/navigateur) et confirmez :
    • Toutes les salles apparaissent dans la console inférieure (MAPA) et sur le canvas isométrique.
    • Cliquer sur un personnage ouvre le Badge ; cliquer sur DEMO anime tout le bureau ; SON 8-BIT et ZOOM fonctionnent.
    • Zéro erreur dans la console du navigateur.
  3. Confidentialité (obligatoire si publication) : assurez-vous qu'aucun secret (sk-..., tokens, chemins d'utilisateur, messages privés ou photos personnelles sans autorisation) n'a été enregistré dans le projet.
  4. Livrez à l'utilisateur le lien local (http://127.0.0.1:3847), la commande en 1 clic (start.bat / ./start.sh) et expliquez comment modifier les salles ou ajouter de nouveaux sprites par la suite.

Skills associés