flox-sharing

Automates sharing and composition of Flox environments via Git and FloxHub.

12|3|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/flox/flox-agentic --skill flox-sharing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flox-sharing
Source: https://github.com/flox/flox-agentic/tree/main/flox-plugin/skills/flox-sharing
Command: npx skills add https://github.com/flox/flox-agentic --skill flox-sharing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Facilitates sharing and composition of Flox environment definitions across projects, reducing duplication and enabling consistent runtimes without exposing source details.

Core Features & Use Cases

  • Shareable environment definitions stored under the .flox/ directory
  • Git-based sharing for development environments alongside source code
  • FloxHub-based sharing for runtime/base environments
  • Safe, deterministic composition with include-based layering
  • Activation, pull, and push workflows for remote environments
  • Team patterns: base + specialization, service libraries, and multi-project stacks
  • Clear guidance for development vs runtime environments and project composition

Quick Start

Activate a shared Flox environment and begin collaboration across teams using FloxHub or Git.

Frequently Asked Questions about flox-sharing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I share a Flox environment definition with my development team?

Share Flox environments by storing definitions in the .flox directory and distributing them via Git for local dev stacks or FloxHub for remote collaboration. This ensures teams access consistent runtimes without exposing source details.

What is the best way to compose multiple Flox environments across different projects?

Compose Flox environments safely using include-based layering to combine base and specialized configurations. This deterministic approach creates multi-project stacks and service libraries while ensuring idempotent composition across your workflows.

Can I use FloxHub to distribute runtime environments separately from source code?

Yes, FloxHub enables sharing of runtime and base environments independently from your source code. Use push and pull workflows to distribute remote environments, separating local development stacks from broader team distribution.

Does Flox support deterministic composition hooks for CI/CD pipelines?

Flox provides safe, deterministic composition with include-based layering and idempotent composition hooks. These ensure your environment assembly remains predictable and reproducible across automated local development and remote deployment scenarios.

When should I use git-based sharing instead of FloxHub for my environments?

Use Git-based sharing for development environments stored alongside your source code, and FloxHub for runtime or base environments distributed separately. This distinction keeps local dev stacks tightly coupled with code while allowing broader team distribution.