Sub-skill of drilling: Drilling Hydraulics (+5).
npx skills add https://github.com/vamseeachanta/workspace-hub --skill drilling-drilling-hydraulicsCopy and paste this command into Claude Code to install the skill
Use this at the end of substantial repo or agent waves to convert evidence-backed lessons into proposed durable assets: skills, scripts, rules/checks, prompt templates, docs, or issues. Always use it when the user mentions flywheel, wave closeout, repo ecosystem learning, durable asset promotion, or learning-to-tools.
Recover and harden digitalmodel Blender automation work in isolated worktrees when uv/editable dependency paths break and local machines lack a Blender executable.
Class-level digitalmodel OrcaWave/OrcaFlex readiness, semantic-proof, fixture-proof, and closeout workflows.
Run digitalmodel tests from isolated worktrees without uv editable-dependency failures by using the main repo's existing virtualenv and PYTHONPATH.
Create evaluation scripts and integration tests for Python scientific libraries in the digitalmodel package. Follows the established pattern from fluids, ht, meshio, sectionproperties, and pygmt evaluations.
Build and extend fixture-backed OrcaFlex reporting proof paths in digitalmodel using stable metadata baselines, normalized HTML snapshots, and reusable reporting test helpers.
| name | drilling-drilling-hydraulics |
| description | Sub-skill of drilling: Drilling Hydraulics (+5). |
| version | 1.0.0 |
| category | engineering |
| type | reference |
| scripts_exempt | true |
# Equivalent Circulating Density (ECD)
ECD = MW + (delta_P_annular / (0.052 * TVD))
# Pressure Loss in Annulus
delta_P = (L * rho * v**2) / (25.8 * (Dh - Dp))
# Bit Hydraulics
HHP = (Q * delta_P_bit) / 1714
HSI = HHP / area_bit
# Bourgoyne-Young Model
ROP = K * exp(a1 + sum(ai * xi))
# Mechanical Specific Energy
MSE = (WOB / area_bit) + (2 * pi * RPM * T) / (60 * area_bit * ROP)
T = T0 + mu * N * L # Torque
F = F0 + mu * N * L # Drag (+ for pulling, - for slack off)
# N is normal force, mu is friction factor
# Kill Mud Weight
KMW = original_MW + (SIDPP / (0.052 * TVD))
# Maximum Allowable Annular Surface Pressure
MAASP = (fracture_gradient - MW) * 0.052 * shoe_TVD
# Kick Tolerance
KT = (FG - MW_current) * shoe_TVD / depth_total
def calculate_ecd(
mud_weight_ppg: float,
annular_pressure_loss_psi: float,
tvd_ft: float
) -> float:
"""
Calculate Equivalent Circulating Density.
Args:
*See sub-skills for full details.*
## Example: Parameter Validation
```python
def validate_drilling_parameters(params: dict) -> None:
"""Validate drilling parameters are within safe ranges."""
if params['mud_weight'] < params['pore_pressure']:
raise ValueError("Mud weight below pore pressure — kick risk!")
if params['mud_weight'] > params['fracture_gradient']:
raise ValueError("Mud weight above fracture gradient — losses risk!")
if params['wob'] > params['bit_rating']:
raise ValueError("WOB exceeds bit rating")