Agent skill · software engineering · affaan-m
flox-environments
Floxで再現可能なクロスプラットフォーム開発環境を作成します — Nixに基づく宣言的な環境マネージャー。次の場合は必ずこのスキルを使用してください: システムレベルの依存関係（コンパイラー、データベース、openssl・libvips・BLAS・LAPACKなどのネイティブライブラリー）を持つプロジェクトを設定する場合; Python、Node.js、Rust、Go、C/C++、Java、Ruby、Elixir、PHP、その他の言語の再現可能なツールチェーンを設定する場合; macOSとLinux間で同一に動作する環境を管理する場合; チームのために正確なパッケージバージョンを固定する場合; ローカルサービス（PostgreSQL、Redis、Kafka）を開発ツールと並行して実行する場合; 単一コマンドで新しい開発者をオンボードする場合; または「自分のマシンでは動く」問題を解決する場合。AI支援やバイブコーディングに特に価値があります — Floxはエージェントがsudoなし、システム汚染なし、サンドボックス制限なしにプロジェクトスコープの環境にツールをインストールでき、結果の環境はリポジトリにコミットされるため、誰でも即座に再現できます。ユーザーがFloxに言及しない場合でも、再現可能、宣言的、クロスプラットフォームな開発環境とシステムパッケージが必要と説明した場合はこのスキルを使用してください。また、ユーザーが.flox/、manifest.toml、flox activate、またはFloxHubに言及した場合も使用してください。
Why this skill is useful
Adds executable scripts and a declarative environment management system for cross-platform development that AI cannot generate on its own.
What it needs
Requires flox installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Flox環境 Floxは単一のTOMLマニフェストで定義される再現可能な開発環境を作成します。チームのすべての開発者が同一のパッケージ、ツール、設定を取得できます — コンテナーやVMなしにmacOSとLinux間で同一です。150,000以上のパッケージにアクセスできるNixの上に構築されています。 アクティベートするタイミング ユーザーが環境管理の問題を抱えている場合、Floxについて言及していなくても、このスキルを使用します。Floxが適切なツールとなるのは: プロジェクトがシステムレベルのパッケージ（コンパイラー、データベース、CLIツール）と言語固有の依存関係を必要とする場合 再現性が重要な場合 — チームメイトのマシン、CI、または新しいラップトップでも同一に動作する必要がある場合 ユーザーが複数のツールの共存を必要とする場合 — 例えばPython 3.11 + PostgreSQL 16 + Redis + Node.jsを一つの環境で クロスプラットフォームサポートが必要な場合（同一設定からmacOSとLinux） AIエージェントがツールをインストールする必要がある場合 — Floxはエージェントがsudoなし、システム汚染なし、サンドボックス制限なしにプロジェクトスコープの環境にパッケージを追加できます ユーザーがシステム依存関係のない単一の言語ランタイムだけが必要な場合、標準ツール（nvm、pyenv、rustup単独）で十分かもしれません。完全なOSレベルの分離が必要な場合、コンテナーがより適切かもしれません。Floxはその中間に位置します: コンテナーのオーバーヘッドなしの宣言的で再現可能な環境。 前提条件: まずFloxをインストールする必要があります — macOS、Linux、Dockerについてはflox.dev/docsを参照してください。 コアコンセプト Flox環境は.flox/env/manifest.tomlで定義され、flox activateでアクティベートされます。マニフェストはパッケージ、環境変数、セットアップフック、シェル設定を宣言します — 環境をどこでも再現するために必要なすべてのものです。 主要なパス: .flox/env/manifest.toml — 環境定義（コミットする） $FLOXENV — インストールされたパッケージへのランタイムパス（/usrに似ている — bin/、lib/、include/を含む） $FLOXENVCACHE — キャッシュ、venv、データの永続ローカルストレージ（リビルド後も存続） $FLOXENVPROJECT — プロジェクトのルートディレクトリ（.flox/が存在する場所） 必須コマンド マニフェスト構造 パッケージインストールパターン 基本インストール バージョン固定 プラットフォーム固有のパッケージ パッケージ競合の解消 2つのパッケージが同じバイナリをインストールする場合、priorityを使用します（数値が低い方が優先）: 一緒にバージョンを解決する必要があるパッケージをグループ化するにはpkg-groupを使用します: 言語固有のレシピ uvを使ったPython Node.js Rust Go C/C++ フックとプロファイル フック — 非インタラクティブなセットアップ フックはすべてのアクティベーション時に実行されます。速くべきで冪等性を保ちます。原則として: 自動的に実行すべきものは[hook]に; ユーザーが入力できるべきものは[profile]に。 プロファイル — インタラクティブシェル設定 プロファイルコードはユーザーのシェルセッションで利用可能です。 アンチパターン 絶対パス フック内でのexitの使用 マニフェストへのシークレットの保存 冪等性ガードなしの遅いフック フックへのユーザーコマンドの配置 フルスタックの例 PostgreSQLを使用したPython APIの完全な環境: サービス付きでアクティベート: flox activate --start-services 環境の共有 Flox環境はgitネイティブです。.flox/ディレクトリをコミットすれば、すべての共同作業者が同じ環境を取得できます: プロジェクト間で再利用可能なベース環境には、FloxHubにプッシュします: [include]で環境を合成します: AI支援とバイブコーディング FloxはAI支援開発とバイブコーディングワークフローに理想的です。AIエージェントが現在の環境で利用できないツール（コンパイラー、データベース、リンター、CLIユーティリティ）を必要とする場合、sudoアクセス不要、システムパッケージの汚染な …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/flox-environments