foundry-setup
First-time setup for the claude-foundry plugin (plugin:foundry@claude-foundry)
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.
| name | foundry-setup |
|---|---|
| description | First-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**