skills.rest
FreeshardBase
FreeshardBaseOFFICIAL
Explore all skills by this author →
GitHub

freeshard-build-and-env

Configure and validate the shard_core development environment with uv and Docker Compose.

47|2|Updated Feb 11, 2025
Search Tags:#development#pytest#uv#docker#environment#freeshard#shard_core
One-click install
npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-build-and-env
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: freeshard-build-and-env
Source: https://github.com/FreeshardBase/freeshard/tree/main/.claude/skills/freeshard-build-and-env
Command: npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-build-and-env

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill resolves the friction of setting up a complex development environment for the shard_core backend, ensuring that dependencies, Docker configurations, and local environment overrides are correctly aligned to prevent common runtime and test failures.

Core Features & Use Cases

  • Environment Provisioning: Automates the synchronization of Python dependencies via uv and validates the local toolchain.
  • Worktree Management: Provides standardized procedures for creating isolated git worktrees to prevent cross-contamination of test environments.
  • Troubleshooting: Offers a structured checklist to diagnose and fix common issues like missing config files, port conflicts, or environment drift.

Quick Start

Run the freeshard-build-and-env skill to perform a fresh environment smoke test and verify your local repository configuration.

Frequently Asked Questions about freeshard-build-and-env

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

FAQPage Schema
How do I set up a FastAPI backend development environment with Docker Compose?▼

Git worktree isolation prevents cross-contamination of test environments by creating separate working directories. This approach manages host-global resources effectively while maintaining consistent dependency resolution across isolated branches.

What is the best way to synchronize Python dependencies using uv.lock?▼

Yes, you can troubleshoot environment drift by following a structured checklist. This diagnostic process identifies and fixes common issues like missing configuration files, port conflicts, or inconsistent local repository states.

Does this development environment configuration work for Linux-based workflows?▼

Yes, this development environment configuration specifically targets Linux-based workflows. It validates the local toolchain and manages host-global resources required for consistent testing within FastAPI and Docker Compose setups.

Why does my pytest testing environment fail after dependency updates?▼

Your pytest environment may fail due to environment drift after dependency updates. A fresh environment smoke test verifies your local repository configuration and ensures host-global resources are correctly managed.

Related Skills

Explore More Software Engineering Skills→
KjdraganKjdragan
1

dependency-management

Manage Python dependencies with uv and resolve missing system libraries.

Community
Intermediate
kilburnkilburn

docker-testing

Run and debug backend and frontend tests inside Docker containers.

Community
Advanced
dandawateydandawatey

git-worktrees

Create isolated Git worktrees for parallel feature branch development.

Community
Intermediate
tethertotetherto
395

setup

Execute predefined shell scripts to automate AI agent environment configuration.

Official
Basic