skills.rest
richardthe3rd
richardthe3rdCOMMUNITY
Explore all skills by this author →
GitHub

build-and-env

Troubleshoot mise-driven build setup and environment configuration issues.

2|3|Updated Nov 28, 2025
Search Tags:#mise#flutter#dev-setup#environment-config#ci-parity#build-toolchain#install-troubleshooting
One-click install
npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill build-and-env
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-and-env
Source: https://github.com/richardthe3rd/cambridge-beer-festival-app/tree/main/.claude/skills/build-and-env
Command: npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill build-and-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork and frustration of setting up the Cambridge Beer Festival app's complex, mise-driven build toolchain from scratch, and resolves common failures like install errors, environment misconfigurations, and mismatches between local and CI builds.

Core Features & Use Cases

  • Full from-scratch setup: Guides you through the project's pinned, self-contained mise bootstrap script with no manual Flutter or node installation required.
  • Environment and trap troubleshooting: Covers layered environment configuration (base/dev/claude-code-web/human), MISE_ENV behavior, and known install traps like GitHub 403 errors and libgit2 transport failures.
  • Introspection and parity: Provides commands to discover tasks, tool versions, and active config, plus guidance to align local builds with CI and add new tools/tasks correctly.
  • Use Case: If running a mise task fails with a 403 error in the Claude Code Web sandbox, this Skill walks you through the verified MISE_ENV workaround to resolve the issue.

Quick Start

Use the build-and-env skill to set up the repo from a fresh machine, troubleshoot mise install or task execution failures, or understand why your local build behaves differently from CI.

Frequently Asked Questions about build-and-env

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

FAQPage Schema
How do I set up the Cambridge Beer Festival app build toolchain from scratch?▼

To set up the build toolchain from scratch, use the project's pinned, self-contained mise bootstrap script, which handles Flutter and node installation automatically without requiring manual setup or version management.

Why does my mise task fail with a GitHub 403 error during install?▼

A mise task failing with a GitHub 403 error during install is a known sandbox-specific trap, often resolved by applying the verified MISE_ENV workaround that adjusts the active layered environment configuration.

How do I debug mismatches between my local build and CI using mise?▼

Debug local and CI build parity by running mise introspection commands to discover active tool versions, tasks, and configuration, ensuring your local MISE_ENV and dart-define settings match the CI environment.

Can I use mise to manage layered environment configurations for different development contexts?▼

Yes, mise supports layered environment configuration with base, dev, claude-code-web, and human contexts, allowing you to toggle MISE_ENV to apply specific settings and install trap workarounds per sandbox.

What is the best way to add new tools or tasks to an existing mise-driven build environment?▼

Add new mise tools or tasks by aligning with the project's deterministic tool version pinning and enforced formatting and linting hooks, ensuring the additions maintain CI parity and avoid install trap failures.

Related Skills

Explore More Software Engineering Skills→
leto-labsleto-labs

repocache

Mirror external repositories locally via Git, jq, and base64 tooling.

Official
Advanced
nickcuypersnickcuypers

flutter-deps-upgrade

Automate Flutter dependency upgrades with verification gates and migration-aware reporting.

Community
Intermediate
louisbrulenaudetlouisbrulenaudet
18

review-configuration

Audit environment variables and build toolchain configurations across monorepo packages.

Community
Advanced
vecearvecear

dev-environment-bootstrapper

Generate version manager configs and setup scripts for multi-language projects.

Community
Intermediate