drillbotics-1-trajectory-planner

Sub-skill of drillbotics: 1. Trajectory Planner (+9).

5 stars

Best use case

drillbotics-1-trajectory-planner is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Sub-skill of drillbotics: 1. Trajectory Planner (+9).

Teams using drillbotics-1-trajectory-planner should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/1-trajectory-planner/SKILL.md --create-dirs "https://raw.githubusercontent.com/vamseeachanta/workspace-hub/main/.agents/skills/_archive/engineering/drilling/drillbotics/1-trajectory-planner/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/1-trajectory-planner/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How drillbotics-1-trajectory-planner Compares

Feature / Agentdrillbotics-1-trajectory-plannerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Sub-skill of drillbotics: 1. Trajectory Planner (+9).

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 1. Trajectory Planner (+9)

## 1. Trajectory Planner


3D directional well-path computation from surface to multiple downhole targets.
Algorithms used by winning teams: cubic Bezier curves, minimum-curvature method.
Constraints: dogleg severity (DLS) limits, survey station uncertainty propagation.

```python
# Key inputs
targets: list[Point3D]     # revealed on competition day
dls_max: float             # deg/100ft — formation / BHA constraint
survey_uncertainty: float  # typical ±0.5° inclination, ±1° azimuth

# Key outputs
planned_path: list[SurveyStation]   # MD, inclination, azimuth at each station
```


## 2. Trajectory Control Optimizer (TCO)


Closed-loop steering of the simulated bit along the planned path. Must correct for
BHA model uncertainty at each survey station. Reinforcement learning has been used
by winning teams (UiS 2021-2022) for generalization to unseen target geometries.


## 3. BHA Model (RSS and Motor)


**Critical constraint**: BHA type (Rotary Steerable System vs Adjustable Kick-Off motor)
is specified on competition day. Both must be pre-implemented and switchable.

Open-source references:
- `MADSim-Wilson-Simple-BHA-Model` (Open Source Drilling Community)
- `Aarsnes-and-Shor-Torsional-Model` (torsional vibration)


## 4. ROP Optimisation


Real-time, formation-dependent optimisation of WOB and RPM to maximise ROP without
causing dysfunctions. Typically a nonlinear constrained optimisation problem.

**Bourgoyne-Young model** (eight-parameter, industry standard):
```
ROP = f(WOB, RPM, d_bit, ECD, formation_coefficients, bit_wear, overbalance, compaction)
```

**Warren model** (simplified, two-parameter):
```
ROP = K * (WOB / d_bit)^a * RPM^b
```

**Status in ACE Engineering**: NOT YET IMPLEMENTED. Gap identified in WRK-375.
Candidate location: `digitalmodel/well/drilling/rop_model.py`


## 5. Torque and Drag


Drillstring friction and axial/torque loads along the wellbore trajectory.
Used for WOB management and stuck-pipe detection.

Open-source reference: `Dixit-Drillstring-Model-2023` (Open Source Drilling Community)

**Status in ACE Engineering**: NOT YET IMPLEMENTED.


## 6. Wellbore Hydraulics / ECD


Managed pressure drilling: keep bottomhole pressure inside the mud-weight window.

| Parameter | Formula | Purpose |
|-----------|---------|---------|
| ECD | `MW + (annular_ΔP / (0.052 × TVD))` | Formation overbalance control |
| Annular velocity | `Q / (d_hole² − d_pipe²) × 0.408` | Cuttings transport |
| Pump pressure | Fanning friction + acceleration components | Surface pump management |

**Status in ACE Engineering**: PARTIAL — CT hydraulics exists at
`digitalmodel/src/digitalmodel/marine_ops/ct_hydraulics/ct_hydraulics.py`
(ECD, pressure drop, Reynolds/friction, pump pressure). Needs generalisation to
arbitrary pipe/annulus diameters and multi-phase flow. Gap: ~250 lines to extend.


## 7. Well Control


Kick detection and automated shut-in. Scored as a separate category.

Detection signals:
- Flow-in/out differential > 5% sustained
- Pit volume gain > threshold
- Standpipe pressure anomaly

False-alarm rate is explicitly scored — conservative triggers that shut in unnecessarily
count against the team.


## 8. Formation Classification (ML)


Real-time identification of formation being drilled from surface drilling signals
(WOB, ROP, torque, vibration). Enables adaptive control parameter switching.

UMaT (2024 winner) used ensemble ML methods + a Python-based digital-twin architecture.


## 9. Operator HMI


Human-in-the-loop interface required since 2021. Criteria:
- Alarm management following alarm philosophy standards
- Levels-of-automation design (operator can always intervene)
- Mitigation of automation complacency ("ironies of automation")


## 10. D-WIS Interoperability (2025-2026 requirement)


All modules must expose data via Drilling Well Information Schema (D-WIS) semantic
network protocols. This is a mandatory gate for Phase II entry in the 2025-2026 cycle.

Reference: https://d-wis.org

---

Related Skills

trip-planner

5
from vamseeachanta/workspace-hub

Use when the user asks to plan, draft, or refine a leisure trip — weekend getaway, road trip, international rail trip, or beach vacation. Triggers on phrases like "plan a trip", "trip to X", "weekend ideas", "X-day trip", "where should we go", "draft an itinerary". Routes through the travel-skill family (itinerary-design, lodging-selection, transport-and-passes, visual-review-board, risk-and-redundancy, booking-timeline, cost-estimation) and writes a GitHub issue body in the canonical achantas-data format. Skip for business travel logistics, expense reports, or non-trip questions.

drillbotics

5
from vamseeachanta/workspace-hub

SPE Drillbotics Mode V (virtual track) reference — competition requirements, module architecture, controller patterns, ROP models, D-WIS interoperability, and ACE Engineering capability mapping

drillbotics-scoring-summary

5
from vamseeachanta/workspace-hub

Sub-skill of drillbotics: Scoring Summary.

drillbotics-published-papers-mode-v

5
from vamseeachanta/workspace-hub

Sub-skill of drillbotics: Published Papers (Mode V).

drillbotics-open-source-building-blocks

5
from vamseeachanta/workspace-hub

Sub-skill of drillbotics: Open-Source Building Blocks.

drillbotics-competition-overview

5
from vamseeachanta/workspace-hub

Sub-skill of drillbotics: Competition Overview.

drillbotics-ace-engineering-gap-vs-drillbotics-requirements

5
from vamseeachanta/workspace-hub

Sub-skill of drillbotics: ACE Engineering Gap vs Drillbotics Requirements.

test-oversized-skill

5
from vamseeachanta/workspace-hub

A test fixture skill that exceeds 200 lines with multiple H2/H3 sections for split testing.

interactive-report-generator

5
from vamseeachanta/workspace-hub

Generate interactive HTML reports with Plotly visualizations from data analysis results. Supports dashboards, charts, and professional styling.

data-validation-reporter

5
from vamseeachanta/workspace-hub

Generate interactive validation reports with quality scoring, missing data analysis, and type checking. Combines Pandas validation, Plotly visualization, and YAML configuration for comprehensive data quality reporting.

agent-os-framework

5
from vamseeachanta/workspace-hub

Generate standardized .agent-os directory structure with product documentation, mission, tech-stack, roadmap, and decision records. Enables AI-native workflows.

OrcaFlex Specialist Skill

5
from vamseeachanta/workspace-hub

```yaml