foundry-setup

First-time setup for the claude-foundry plugin (plugin:foundry@claude-foundry)

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

When & Why to Use This Skill

The Foundry Setup skill is a specialized utility designed to automate the initial configuration and environment preparation for the Claude Foundry plugin. It streamlines the developer onboarding process by performing idempotent pre-flight checks on essential dependencies like MCP, Python, and Git, while automatically managing workspace permissions and generating required configuration files such as TOML and CLAUDE.md.

Use Cases

  • Initial Environment Provisioning: Automatically verify and install necessary prerequisites (Python, Git, MCP) to ensure the system is ready for Claude Foundry development.
  • Automated Workspace Configuration: Generate and standardize project-specific configuration files (TOML) and CLAUDE.md settings to maintain consistency across development environments.
  • Pre-flight System Auditing: Use the --check flag to perform a non-destructive diagnostic of the current setup to identify missing dependencies or permission issues before deployment.
  • Idempotent Infrastructure Setup: Safely re-run setup phases to repair corrupted configurations or update environment variables without affecting existing stable settings.
namefoundry-setup
descriptionFirst-time setup for the foundry plugin (plugin:foundry@claude-foundry)

Foundry Setup Skill

First-time setup for the foundry plugin. This skill is idempotent and safe to run multiple times.

Argument Handling

Check if $ARGUMENTS contains --check or --preflight:

  • If flag present: Run only Phase 1 (Pre-flight Checks), display results, then stop
  • If no flag: Run all phases (full setup)

Execution

MANDATORY: Read references/setup.md before proceeding. It contains the detailed phase instructions.

Flow

- **Entry** → Read `references/setup.md` (MANDATORY) → Ensure Full Mode → Preflight: MCP, Python, Git
  - [--check?] → **Exit**
  - [else] → Permissions → Workspace
    - [toml created?] → FeatureFlags → Providers → Research → TestConfig
    - [else] → Create TOML → FeatureFlags → Providers → Research → TestConfig
    - CLAUDE.md Configuration → Summary → **Exit**