Skip to content
This repository was archived by the owner on Oct 27, 2026. It is now read-only.
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 6 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This project includes specialized knowledge and tooling for Flox workflows, best

### Skills Library

The repository includes six specialized skills, each focused on a specific aspect of Flox:
The repository includes five specialized skills, each focused on a specific aspect of Flox:

#### 1. **flox-environments**
Manage reproducible development environments with Flox. This is the foundational skill that should be used first when creating any new project. Covers:
Expand All @@ -19,37 +19,31 @@ Manage reproducible development environments with Flox. This is the foundational
- Environment configuration and secrets management
- Reproducible development workflows
- Sharing, composing, and layering environments — composition via `[include]`, remote environments, FloxHub, team collaboration (see `references/sharing.md`)
- Running services, background processes, and databases (see `references/services.md`)

#### 2. **flox-services**
Running services and background processes in Flox environments. Covers:
- Service configuration and lifecycle management
- Network services (HTTP servers, databases, etc.)
- Logging and debugging patterns
- Service orchestration

#### 3. **flox-builds**
#### 2. **flox-builds**
Building and packaging applications with Flox. Covers:
- Manifest builds for quick iteration
- Nix expression builds for guaranteed reproducibility
- Sandbox modes and build isolation
- Multi-stage builds
- Packaging assets and artifacts

#### 4. **flox-containers**
#### 3. **flox-containers**
Containerizing Flox environments with Docker/Podman. Covers:
- Creating container images from Flox environments
- OCI exports
- Multi-stage container builds
- Deployment workflows

#### 5. **flox-publish**
#### 4. **flox-publish**
Publishing packages to Flox for distribution and sharing. Covers:
- Package publishing workflows
- Organization and personal namespace management
- Package versioning and distribution
- Sharing built packages across teams

#### 6. **flox-cuda**
#### 5. **flox-cuda**
CUDA and GPU development with Flox (Linux only). Covers:
- NVIDIA CUDA toolkit setup
- GPU computing workflows
Expand Down Expand Up @@ -115,7 +109,6 @@ Supported agents include Cursor, GitHub Copilot, Windsurf, Gemini, and

For detailed documentation on each skill, see the individual SKILL.md files in the `skills/` directory:
- `skills/flox-environments/SKILL.md`
- `skills/flox-services/SKILL.md`
- `skills/flox-builds/SKILL.md`
- `skills/flox-containers/SKILL.md`
- `skills/flox-publish/SKILL.md`
Expand Down
2 changes: 2 additions & 0 deletions flox-plugin/skills/flox-environments/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ manifest sections, gotchas) and go well beyond general knowledge.
- **Sharing, composition & layering** — composing environments via `[include]`,
runtime layering, remote environments, push/pull, FloxHub, team collaboration
→ read `references/sharing.md`
- **Services** — background processes, daemons, databases, logging, service
debugging → read `references/services.md`

## Working Style & Structure

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,3 @@
---
name: flox-services
description: Running services and background processes in Flox environments. Use for service configuration, network services, logging, database setup, and service debugging.
---

# Flox Services Guide

## Running Services in Flox Environments
Expand Down Expand Up @@ -291,8 +286,3 @@ Always `mkdir -p` for data directories in service commands.
### Port Conflicts
Use configurable ports via variables to avoid conflicts with other services.

## Related Skills

- **flox-environments** - Environment basics and package installation
- **flox-sharing** - Composing environments with shared services
- **flox-containers** - Running services in containers
Loading