wellbore-stability

Calculate safe mud weight windows using Kirsch equations and Mohr-Coulomb criteria.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/jpfielding/claude.pnge --skill wellbore-stability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wellbore-stability
Source: https://github.com/jpfielding/claude.pnge/tree/main/skills/wellbore-stability
Command: npx skills add https://github.com/jpfielding/claude.pnge --skill wellbore-stability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps engineers predict and prevent wellbore instability issues, such as breakouts and fractures, by analyzing in-situ stresses and rock properties to define a safe drilling fluid weight window.

Core Features & Use Cases

  • Stress State Analysis: Calculates vertical, minimum, and maximum horizontal stresses at depth.
  • Mud Weight Window Calculation: Determines the safe range of mud weight to prevent shear failure (breakout) and tensile fracture.
  • Use Case: An engineer needs to drill a well in the Marcellus shale. They use this Skill to input log data and estimated stress gradients to calculate the safe mud weight window, ensuring the wellbore remains stable throughout the drilling process.

Quick Start

Calculate the mud weight window for a vertical well at 7,500 ft TVD using provided stress gradients and UCS.

Frequently Asked Questions about wellbore-stability

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

FAQPage Schema
How do I calculate the mud weight window to prevent wellbore breakout during drilling?

This Skill analyzes in-situ stress states, pore pressure, and rock strength to determine safe mud weight windows. It predicts borehole breakout and assesses fracture initiation risks using Kirsch equations, Mohr-Coulomb criteria, and Eaton's pore pressure method with Python scripts.

What is wellbore stability analysis and how does it use geomechanics to prevent drilling failures?

Wellbore stability analysis uses geomechanics to predict and prevent borehole instability issues like breakouts and fractures. By analyzing in-situ stresses and rock properties, it defines a safe drilling fluid weight window to ensure the wellbore remains stable throughout drilling.

How do I predict borehole breakout and fracture initiation risks for a vertical well?

You predict borehole breakout and fracture initiation risks by inputting log data and estimated stress gradients for your target depth. The Skill calculates vertical, minimum, and maximum horizontal stresses to evaluate shear and tensile failure limits based on rock strength.

Can I use this geomechanics analysis for drilling in the Marcellus shale or Appalachian basin?

Yes, you can use this geomechanics analysis for drilling in the Marcellus shale and Appalachian basin. The Skill includes reference data for Appalachian basin conditions and supports calculating safe mud weight windows at specific depths like 7,500 ft TVD.

What input data do I need to perform stress state analysis and pore pressure calculations?

To perform stress state analysis and pore pressure calculations, you need log data, estimated stress gradients, and uniaxial compressive strength (UCS) values. The Skill uses Eaton's pore pressure method and Mohr-Coulomb criteria to process these inputs into a safe mud weight window.