Communitygithub.com

ComeOnOliver/skillshub

Valide les variables d'environnement, les fichiers de configuration et garantit que tous les paramètres requis sont documentés. À utiliser avec les fichiers .env, les configurations ou les paramètres de déploiement.

Qu'est-ce que skillshub ?

La compétence `ComeOnOliver/skillshub` (Configuration Validator) est un outil spécialisé dans la validation des fichiers de configuration et des variables d'environnement. Son objectif principal est de détecter et prévenir les erreurs d'exécution causées par des paramètres manquants, mal formatés ou non sécurisés, ce qui la rend particulièrement utile lors de la configuration de déploiements, de l'utilisation de fichiers `.env` ou de tout projet nécessitant une gestion rigoureuse des réglages. Elle fonctionne en plusieurs étapes : recherche de fichiers de configuration (`.env`, `config.json`, `settings.py`, etc.), détection des variables manquantes en comparant `.env.example` et `.env`, validation du format des variables (comme les guillemets manquants ou les protocoles URL), et vérification des types (nombre, booléen, URL). La compétence propose également des scripts de validation en JavaScript et Python, des schémas de configuration avec Joi, des vérifications de sécurité (comme l'absence de secrets dans les commits ou dans le code), la génération de fichiers `.env.example`, la gestion de configurations par environnement (développement, production, test), et des bonnes pratiques comme la documentation via un fichier `CONFIG.md` ou l'utilisation de gestionnaires de secrets. Elle prend en charge tous les langages et frameworks qui utilisent des variables d'environnement (Node.js, Python, etc.) et peut être intégrée à des pipelines CI/CD pour échouer rapidement en cas de mauvaise configuration.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/crazydubya/configuration-validator

Demander à votre IA préférée

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

Documentation

Validateur de Configuration

Valide les fichiers de configuration et les variables d'environnement pour éviter les erreurs d'exécution et les paramètres manquants.

Quand l'utiliser

  • Travailler avec des variables d'environnement ou des fichiers de configuration
  • Problèmes de déploiement ou de configuration
  • L'utilisateur mentionne ".env", "config", "variables d'environnement" ou "paramètres"

Instructions

1. Trouver les fichiers de configuration

Recherchez :

  • .env, .env.example, .env.local
  • config/, config.js, config.json
  • settings.py, application.yml
  • appsettings.json, .env.production

2. Détecter les variables manquantes

Comparer .env.example vs .env :

# Variables dans l'exemple mais pas dans .env
comm -23 <(grep -o '^[A-Z_]*' .env.example | sort) <(grep -o '^[A-Z_]*' .env | sort)

Variables requises courantes :

DATABASE_URL
API_KEY
SECRET_KEY
NODE_ENV
PORT

3. Valider le format des variables

Vérifier les problèmes courants :

// Guillemets manquants pour les valeurs avec espaces
DATABASE_URL=postgres://localhost/db name  // Mauvais
DATABASE_URL="postgres://localhost/db name"  // Bon

// Protocole manquant
API_URL=example.com  // Mauvais
API_URL=https://example.com  // Bon

// Booléen comme chaîne
DEBUG=true  // Peut être interprété comme une chaîne
DEBUG=1  // Plus explicite

4. Valider les variables requises à l'exécution

Exemple Node.js :

const requiredEnvVars = [
  'DATABASE_URL',
  'API_KEY',
  'JWT_SECRET'
];

const missing = requiredEnvVars.filter(v => !process.env[v]);

if (missing.length > 0) {
  throw new Error(`Variables d'env manquantes : ${missing.join(', ')}`);
}

Exemple Python :

import os

REQUIRED_ENV_VARS = [
    'DATABASE_URL',
    'SECRET_KEY',
    'ALLOWED_HOSTS'
]

missing = [var for var in REQUIRED_ENV_VARS if not os.getenv(var)]

if missing:
    raise EnvironmentError(f"Variables d'env manquantes : {', '.join(missing)}")

5. Validation des types

Valider les types :

const config = {
  port: parseInt(process.env.PORT || '3000', 10),
  debug: process.env.DEBUG === 'true',
  apiUrl: new URL(process.env.API_URL), // Lance une exception si invalide
  maxConnections: Number(process.env.MAX_CONNECTIONS),
};

// Valider
if (isNaN(config.port) || config.port < 1 || config.port > 65535) {
  throw new Error('PORT doit être un numéro de port valide');
}

6. Générer .env.example

Créer un modèle à partir du .env réel :

# Supprimer les valeurs, garder les clés
sed 's/=.*/=/' .env > .env.example

Ou avec des placeholders :

DATABASE_URL=postgres://utilisateur:motdepasse@localhost:5432/nombdd
API_KEY=votre_cle_api_ici
SECRET_KEY=generer_secret_aleatoire
PORT=3000
NODE_ENV=development

7. Schéma de configuration

Définir un schéma (exemple avec Joi) :

const Joi = require('joi');

const envSchema = Joi.object({
  NODE_ENV: Joi.string()
    .valid('development', 'production', 'test')
    .required(),
  PORT: Joi.number()
    .port()
    .default(3000),
  DATABASE_URL: Joi.string()
    .uri()
    .required(),
  API_KEY: Joi.string()
    .min(32)
    .required(),
  DEBUG: Joi.boolean()
    .default(false),
}).unknown();

const { error, value } = envSchema.validate(process.env);

if (error) {
  throw new Error(`Erreur de validation de config : ${error.message}`);
}

module.exports = value;

8. Vérifications de sécurité

Ne pas commit les secrets :

# Vérifier si .env est dans .gitignore
if ! grep -q "^\.env$" .gitignore; then
  echo "Attention : .env n'est pas dans .gitignore"
fi

# Vérifier les secrets codés en dur dans le code
grep -r "api_key.*=.*['\"]" --exclude-dir=node_modules

Problèmes de sécurité courants :

  • Mots de passe/clés codés en dur
  • Secrets par défaut en production
  • Configurations sensibles exposées
  • Secrets non chiffrés

9. Configurations spécifiques à l'environnement

Organiser par environnement :

.env.development
.env.staging
.env.production
.env.test

Charger de manière appropriée :

require('dotenv').config({
  path: `.env.${process.env.NODE_ENV || 'development'}`
});

10. Documenter toutes les variables

Créer CONFIG.md :

# Configuration

## Variables d'environnement

### Requises

- `DATABASE_URL`: Chaîne de connexion PostgreSQL
  - Format : `postgres://utilisateur:mdp@hôte:port/bdd`
  - Exemple : `postgres://app:secret@localhost:5432/monapp`

- `API_KEY`: Clé API tierce
  - Obtenir depuis : https://dashboard.example.com
  - Périmètres requis : lecture, écriture

### Optionnelles

- `PORT`: Port du serveur (par défaut : 3000)
- `DEBUG`: Activer les logs de débogage (par défaut : false)
- `MAX_CONNECTIONS`: Taille du pool de connexions BDD (par défaut : 10)

## Configuration

1. Copier `.env.example` vers `.env`
2. Remplir toutes les valeurs requises
3. Exécuter `npm run validate-config` pour vérifier

11. Script de validation

Créer scripts/validate-config.js :

const fs = require('fs');

function validateConfig() {
  const required = ['DATABASE_URL', 'API_KEY'];
  const missing = required.filter(v => !process.env[v]);

  if (missing.length > 0) {
    console.error(`❌ Manquant : ${missing.join(', ')}`);
    process.exit(1);
  }

  console.log('✓ Toutes les variables de configuration requises sont présentes');
}

validateConfig();

12. Bonnes pratiques

  • Ne jamais commit .env : Toujours dans .gitignore
  • Maintenir .env.example : Le tenir à jour
  • Valider au démarrage : Échouer rapidement si mal configuré
  • Utiliser des valeurs par défaut robustes : Solutions de repli sensées
  • Tout documenter : Expliquer chaque variable
  • Rotation des secrets : Mettre à jour régulièrement les clés
  • Utiliser des gestionnaires de secrets : Vault, AWS Secrets Manager en production
  • Vérifier les types : Valider les types, pas seulement la présence

Fichiers supports

  • templates/config-validator.js
  • templates/.env.example
  • scripts/generate-env-example.sh

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés