stacks-env

Manages typed, encrypted environment variables for Stacks applications with CI detection.

2|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/bughq/bughq --skill stacks-env-bughq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacks-env
Source: https://github.com/bughq/bughq/tree/main/.claude/skills/stacks-env
Command: npx skills add https://github.com/bughq/bughq --skill stacks-env-bughq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the complexity of managing environment variables across different development, testing, and production environments by providing a type-safe proxy, automatic coercion, and built-in encryption.

Core Features & Use Cases

  • Typed Environment Proxy: Access environment variables with full TypeScript support and automatic type coercion for booleans and numbers.
  • Secure Configuration: Utilize AES-256-GCM encryption for sensitive environment values and manage them via a dedicated CLI.
  • Runtime & CI Detection: Automatically detect the current runtime environment (Bun/Node) and CI provider to adjust application behavior dynamically.

Quick Start

Use the stacks-env skill to generate a new encryption keypair for your project environment variables.

Frequently Asked Questions about stacks-env

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

FAQPage Schema
How do I manage environment variables with type-safe access in TypeScript?

Type-safe environment variable management provides a TypeScript proxy with automatic type coercion for booleans and numbers. It ensures your configuration values are strictly typed during development and production lifecycles.

How does AES-256-GCM encryption work for environment variables?

AES-256-GCM encryption secures sensitive environment variables by utilizing a dedicated CLI and secp256k1 key exchange. This cryptographic security ensures data remains protected across development and production environments.

Can I detect runtime environments like Bun or Node automatically?

Automatic runtime platform detection identifies whether your application is running on Bun or Node. It also detects the CI provider to dynamically adjust application behavior across diverse deployment environments.

What is the best way to generate an encryption keypair for environment configuration?

Generating an encryption keypair for environment configuration uses a dedicated CLI to create secp256k1 keys. This process establishes the cryptographic foundation required to encrypt and manage sensitive environment variables securely.

Does this environment management approach work across different CI providers?

Yes, environment management supports diverse deployment environments through automatic CI provider identification. It dynamically adjusts configuration behavior by detecting the current runtime and CI platform.

Why do I need type coercion for environment variables in a Stacks application?

Type coercion for environment variables is needed to automatically convert string values into typed booleans and numbers. This prevents runtime type errors and provides full TypeScript support when accessing configurations.