bootstrap-fly-env-sync

Generate batched fly secrets set commands from local .env files.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/agoodway/GoodSkills --skill bootstrap-fly-env-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-fly-env-sync
Source: https://github.com/agoodway/GoodSkills/tree/main/skills/bootstrap-fly-env-sync
Command: npx skills add https://github.com/agoodway/GoodSkills --skill bootstrap-fly-env-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Keeps Fly.io app configuration consistent by turning local .env files into correctly chunked Fly secrets, so you can avoid slow, error-prone manual secret setting.

Core Features & Use Cases

  • Bootstraps a sync script: Creates scripts/env-to-fly-secrets.sh that converts a .env file into batched fly secrets set commands to reduce Fly CLI limits issues.
  • Safe-by-default dry runs: Prints the commands first and only applies them when you pass --execute, reducing accidental misconfiguration risk.
  • Project-aware setup: Optionally copies a template to .env.prod, updates .gitignore to ignore .env.prod, and adds a Justfile recipe when a justfile exists.
  • Handles common .env formats: Skips comments/blank lines, supports export KEY=VALUE, validates key format, trims whitespace, and strips surrounding quotes from values.

Quick Start

Ask your agent to run the bootstrap command to create the env-to-Fly secrets script in your repo: npx skills add agoodway/GoodSkills --skill bootstrap-fly-env-sync

Frequently Asked Questions about bootstrap-fly-env-sync

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

FAQPage Schema
How do I sync a .env file to Fly.io secrets?

Syncing .env files to Fly.io secrets involves generating a bash script that parses local environment variables and converts them into batched fly secrets set commands. This avoids manual entry and prevents CLI argument limit issues.

How do I set Fly.io secrets from a .env file without mistakes?

You can safely set Fly.io secrets from a .env file by running a generated script in dry-run mode first. This prints the proposed fly secrets set commands so you can review them before passing --execute to apply changes.

Can I use a bash script to automate Fly.io environment variable deployment?

Yes, you can use a bash script to automate Fly.io environment variable deployment. The script skips comments and blank lines, validates key formats, trims whitespace, and strips surrounding quotes from values.

Does the Fly.io env sync script support production environment files?

Yes, the Fly.io env sync script supports production environment files. It can optionally copy a template to .env.prod, update .gitignore to ignore .env.prod, and add a Justfile recipe when a justfile exists.

Why do fly secrets set commands fail when pushing many environment variables?

Fly secrets set commands can fail when pushing many environment variables due to CLI argument limits. Generating batched commands from a .env file chunks the variables into smaller groups to avoid these limits.

What is the best way to manage Fly.io app configuration across development workflows?

The best way to manage Fly.io app configuration across development workflows is synchronizing local .env files into Fly secrets via an automated script. This keeps app configuration consistent and reduces manual errors.