Communitygithub.com

設定値バリデーター

環境変数や設定ファイルを検証し、すべての必須設定がドキュメント化されているかを確認します。.env ファイル、設定、デプロイ設定を扱う際に使用します。

設定値バリデーター とは?

このスキルは、環境変数や設定ファイルの欠落や不整合を検出し、ランタイムエラーを未然に防ぐための包括的な設定値バリデーターです。.env、config、settings といったキーワードが検出された場合や、デプロイ・設定関連のトラブルシューティング時に自動的に使用されます。Node.js、Pythonなど複数の言語に対応し、変数の欠落チェック、型検証、セキュリティレビュー、環境別設定の管理、設定スキーマの定義、ドキュメント生成といった一連のワークフローを提供します。具体的なコード例(JavaScript、Python)やCLIコマンド、Joiを使ったスキーマ検証、.gitignore確認、CONFIG.md生成手順を含んでおり、設定管理のベストプラクティスに従って開発者がすぐに実践できる内容になっています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

設定値バリデーター は何をしますか?

設定ファイルと環境変数を検証し、ランタイムエラーや設定漏れを防止します。

使用するタイミング

  • 環境変数や設定ファイルを扱っているとき
  • デプロイや設定に関する問題が発生したとき
  • ユーザーが「.env」「config」「環境変数」「設定」に言及したとき

手順

1. 設定ファイルを探す

以下を検索してください:

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

2. 欠落している変数を検出する

.env.example と .env を比較:

# .env.example にあって .env にない変数
comm -23 <(grep -o '^[A-Z_]*' .env.example | sort) <(grep -o '^[A-Z_]*' .env | sort)

一般的な必須変数:

DATABASE_URL
API_KEY
SECRET_KEY
NODE_ENV
PORT

3. 変数の形式を検証する

よくある問題を確認:

// スペースを含む値に引用符がない
DATABASE_URL=postgres://localhost/db name  // 悪い
DATABASE_URL="postgres://localhost/db name"  // 良い

// プロトコルがない
API_URL=example.com  // 悪い
API_URL=https://example.com  // 良い

// 真偽値が文字列として解釈される
DEBUG=true  // 文字列として解釈される可能性あり
DEBUG=1  // より明示的

4. 実行時に必須変数を検証する

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(`Missing required env vars: ${missing.join(', ')}`);
}

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"Missing env vars: {', '.join(missing)}")

5. 型検証

型を検証:

const config = {
  port: parseInt(process.env.PORT || '3000', 10),
  debug: process.env.DEBUG === 'true',
  apiUrl: new URL(process.env.API_URL), // 不正な場合に例外をスロー
  maxConnections: Number(process.env.MAX_CONNECTIONS),
};

// 検証
if (isNaN(config.port) || config.port < 1 || config.port > 65535) {
  throw new Error('PORT must be a valid port number');
}

6. .env.example を生成する

実際の .env からテンプレートを作成:

# 値を削除し、キーのみ残す
sed 's/=.*/=/' .env > .env.example

またはプレースホルダー付き:

DATABASE_URL=postgres://user:password@localhost:5432/dbname
API_KEY=your_api_key_here
SECRET_KEY=generate_random_secret
PORT=3000
NODE_ENV=development

7. 設定スキーマ

スキーマの定義(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(`Config validation error: ${error.message}`);
}

module.exports = value;

8. セキュリティチェック

シークレットをコミットしない:

# .env が gitignore されているか確認
if ! grep -q "^\.env$" .gitignore; then
  echo "警告: .env が .gitignore にありません"
fi

# コード内のハードコードされたシークレットを確認
grep -r "api_key.*=.*['\"]" --exclude-dir=node_modules

よくあるセキュリティ問題:

  • ハードコードされたパスワード/キー
  • 本番環境でのデフォルトシークレット
  • 機密設定の露出
  • 暗号化されていないシークレット

9. 環境別設定

環境ごとに整理:

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

適切に読み込む:

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

10. すべての変数をドキュメント化する

CONFIG.md を作成:

# 設定

## 環境変数

### 必須

- `DATABASE_URL`: PostgreSQL 接続文字列
  - 形式: `postgres://user:pass@host:port/db`
  - 例: `postgres://app:secret@localhost:5432/myapp`

- `API_KEY`: サードパーティ API キー
  - 入手元: https://dashboard.example.com
  - 必要なスコープ: read, write

### オプション

- `PORT`: サーバーポート(デフォルト: 3000)
- `DEBUG`: デバッグログを有効にする(デフォルト: false)
- `MAX_CONNECTIONS`: データベースプールサイズ(デフォルト: 10)

## セットアップ

1. `.env.example` を `.env` にコピー
2. すべての必須値を入力
3. `npm run validate-config` を実行して検証

11. 検証スクリプト

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(`❌ 欠落: ${missing.join(', ')}`);
    process.exit(1);
  }

  console.log('✓ すべての必須設定変数が存在します');
}

validateConfig();

12. ベストプラクティス

  • .env を絶対にコミットしない: 常に gitignore すること
  • .env.example を維持する: 最新の状態を保つ
  • 起動時に検証する: 設定ミスがあればすぐに検出
  • 適切なデフォルト値を使う: 賢いフォールバックを用意
  • すべてをドキュメント化する: 各変数を説明する
  • シークレットをローテーションする: 定期的にキーを更新
  • シークレットマネージャーを使用する: 本番環境では Vault、AWS Secrets Manager などを利用
  • 型チェックを行う: 存在確認だけでなく型も検証する

サポートファイル

  • 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

関連スキル