Skip to main content Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Métiers associés SOC
Basé sur la classification professionnelle SOC
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/BEKO2210/Firstbrain --skill environment-setup-guideLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... name environment-setup-guide description Guide developers through setting up development environments with proper tools, dependencies, and configurations type skill created 2026-02-27T00:00:00.000Z domain communication-content category documentation risk unknown source community tags ["skill","communication-content","documentation","environment","setup"]
Environment Setup Guide
Overview
Help developers set up complete development environments from scratch. This skill provides step-by-step guidance for installing tools, configuring dependencies, setting up environment variables, and verifying the setup works correctly.
When to Use This Skill
Use when starting a new project and need to set up the development environment
Use when onboarding new team members to a project
Use when switching to a new machine or operating system
Use when troubleshooting environment-related issues
Use when documenting setup instructions for a project
Use when creating development environment documentation
How It Works
Step 1: Identify Requirements
I'll help you determine what needs to be installed:
Programming language and version (Node.js, Python, Go, etc.)
Package managers (npm, pip, cargo, etc.)
Database systems (PostgreSQL, MongoDB, Redis, etc.)
Development tools (Git, Docker, IDE extensions, etc.)
Environment variables and configuration files
Step 2: Check Current Setup
Before installing anything, I'll help you check what's already installed:
node --version
python --version
git --version
docker --version
Step 3: Provide Installation Instructions
I'll give platform-specific installation commands:
macOS: Using HomebrewLinux: Using apt, yum, or package managerWindows: Using Chocolatey, Scoop, or direct installers
Step 4: Configure the Environment
Help set up:
Environment variables (.env files)
Configuration files (.gitconfig, .npmrc, etc.)
IDE settings (VS Code, IntelliJ, etc.)
Shell configuration (.bashrc, .zshrc, etc.)
Step 5: Verify Installation
Provide verification steps to ensure everything works:
Run version checks
Test basic commands
Verify database connections
Check environment variables are loaded
Examples
Example 1: Node.js Project Setup
## Setting Up Node.js Development Environment
### Prerequisites
- macOS, Linux, or Windows
-
-
### Step 1: Install Node.js
**macOS (using Homebrew):**
`\`
# Install Homebrew if not installed
# Install Node.js
`\`
**Linux (Ubuntu/Debian):**
`\`
# Update package list
# Install Node.js and npm
_20.x | sudo -E bash -
sudo apt install -y nodejs
\`\`\`
**Windows (using Chocolatey):**
\`\`\`powershell
# Install Chocolatey if not installed
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# Install Node.js
choco install nodejs
\`\`\`
### Step 2: Verify Installation
\`\`\`bash
node --version # Should show v20.x.x or higher
npm --version # Should show 10.x.x or higher
\`\`\`
### Step 3: Install Project Dependencies
\`\`\`bash
# Clone the repository
git clone https://github.com/your-repo/project.git
cd project
# Install dependencies
npm install
\`\`\`
### Step 4: Set Up Environment Variables
Create a \`.env\` file:
\`\`\`bash
# Copy example environment file
cp .env.example .env
# Edit with your values
nano .env
\`\`\`
Example \`.env\` content:
\`\`\`
NODE_
_URL=postgresql://localhost:5432/mydb
API_
`\`
### Step 5: Run the Project
`\`
# Start development server
# Should see: Server running on http://localhost:3000
`\`
### Troubleshooting
**Problem:**
**Solution:**
`source ~/.bashrc\`
`source ~/.zshrc\`
**Problem:**
**Solution:**
`\`
`\`
Example 2: Python Project Setup ## Setting Up Python Development Environment
### Step 1: Install Python
**macOS:**
\`\` \`bash
brew install python@3.11
\`\` \`
**Linux:**
\`\` \`bash
sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip
\`\` \`
**Windows:**
\`\` \`powershell
choco install python --version=3.11
\`\` \`
### Step 2: Verify Installation
\`\` \`bash
python3 --version # Should show Python 3.11.x
pip3 --version # Should show pip 23.x.x
\`\` \`
### Step 3: Create Virtual Environment
\`\` \`bash
# Navigate to project directory
cd my-project
# Create virtual environment
python3 -m venv venv
# Activate virtual environment
# macOS/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate
\`\` \`
### Step 4: Install Dependencies
\`\` \`bash
# Install from requirements.txt
pip install -r requirements.txt
# Or install packages individually
pip install flask sqlalchemy python-dotenv
\`\` \`
### Step 5: Set Up Environment Variables
Create \`.env\` file:
\`\` \`
FLASK_APP=app.py
FLASK_ ENV=development
DATABASE_URL=sqlite:///app.db
SECRET_ KEY=your-secret-key-here
\`\` \`
### Step 6: Run the Application
\`\` \`bash
# Run Flask app
flask run
# Should see: Running on http://127.0.0.1:5000
\`\` \`
Example 3: Docker Development Environment ## Setting Up Docker Development Environment
### Step 1: Install Docker
**macOS:**
\`\` \`bash
brew install --cask docker
# Or download Docker Desktop from docker.com
\`\` \`
**Linux:**
\`\` \`bash
# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Add user to docker group
sudo usermod -aG docker $USER
newgrp docker
\`\` \`
**Windows:**
Download Docker Desktop from docker.com
### Step 2: Verify Installation
\`\` \`bash
docker --version # Should show Docker version 24.x.x
docker-compose --version # Should show Docker Compose version 2.x.x
\`\` \`
### Step 3: Create docker-compose.yml
\`\` \`yaml
version: '3.8'
services:
app:
build: .
ports:
- "3000:3000"
environment:
- NODE_ENV=development
- DATABASE_URL=postgresql://postgres:password@db:5432/mydb
volumes:
- .:/app
- /app/node_modules
depends_on:
- db
db:
image: postgres:15
environment:
- POSTGRES_USER=postgres
- POSTGRES_PASSWORD=password
- POSTGRES_DB=mydb
ports:
- "5432:5432"
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
postgres_data:
\`\`\`
### Step 4: Start Services
\`\`\`bash
# Build and start containers
docker-compose up -d
# View logs
docker-compose logs -f
# Stop services
docker-compose down
\`\`\`
### Step 5: Verify Services
\`\`\`bash
# Check running containers
docker ps
# Test database connection
docker-compose exec db psql -U postgres -d mydb
\`\`\`
Best Practices
✅ Do This
Document Everything - Write clear setup instructionsUse Version Managers - nvm for Node, pyenv for PythonCreate .env.example - Show required environment variablesTest on Clean System - Verify instructions work from scratchInclude Troubleshooting - Document common issues and solutionsUse Docker - For consistent environments across machinesPin Versions - Specify exact versions in package filesAutomate Setup - Create setup scripts when possibleCheck Prerequisites - List required tools before startingProvide Verification Steps - Help users confirm setup works
❌ Don't Do This
Don't Assume Tools Installed - Always check and provide install instructionsDon't Skip Environment Variables - Document all required variablesDon't Use Sudo with npm - Fix permissions insteadDon't Forget Platform Differences - Provide OS-specific instructionsDon't Leave Out Verification - Always include test stepsDon't Use Global Installs - Prefer local/virtual environmentsDon't Ignore Errors - Document how to handle common errorsDon't Skip Database Setup - Include database initialization steps
Common Pitfalls
Problem: "Command not found" after installation Symptoms: Installed tool but terminal doesn't recognize it
Solution:
Restart terminal or source shell config
Check PATH environment variable
Verify installation location
echo $PATH
export PATH="/usr/local/bin:$PATH "
Problem: Permission errors with npm/pip Symptoms: "EACCES" or "Permission denied" errors
Solution:
Don't use sudo
Fix npm permissions or use nvm
Use virtual environments for Python
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
Problem: Port already in use Symptoms: "Port 3000 is already in use"
Solution:
Find and kill process using the port
Use a different port
lsof -i :3000
kill -9 <PID>
PORT=3001 npm start
Problem: Database connection fails Symptoms: "Connection refused" or "Authentication failed"
Solution:
Verify database is running
Check connection string
Verify credentials
sudo systemctl status postgresql
psql -h localhost -U postgres -d mydb
Setup Script Template Create a setup.sh script to automate setup:
#!/bin/bash
echo "🚀 Setting up development environment..."
command -v node >/dev/null 2>&1 || { echo "❌ Node.js not installed" ; exit 1; }
command -v git >/dev/null 2>&1 || { echo "❌ Git not installed" ; exit 1; }
echo "✅ Prerequisites check passed"
echo "📦 Installing dependencies..."
npm install
if [ ! -f .env ]; then
echo "📝 Creating .env file..."
cp .env.example .env
echo "⚠️ Please edit .env with your configuration"
fi
echo "🗄️ Running database migrations..."
npm run migrate
echo "🔍 Verifying setup..."
npm run test :setup
echo "✅ Setup complete! Run 'npm run dev' to start"
Related Skills
@brainstorming - Plan environment requirements before setup@systematic-debugging - Debug environment issues@doc-coauthoring - Create setup documentation@git-pushing - Set up Git configuration
Additional Resources
Pro Tip: Create a setup.sh or setup.ps1 script to automate the entire setup process. Test it on a clean system to ensure it works!
Connections
Domain: [[Kommunikation & Content]]Kategorie: [[Dokumentation & Wissen]]Navigation: [[Skills Uebersicht]], [[Home]] 