home / skills / a5c-ai / babysitter / soil-classification-tool

soil-classification-tool skill

safe

/plugins/babysitter/skills/babysit/process/specializations/domains/science/civil-engineering/skills/soil-classification-tool

This skill classifies soils with USCS and AASHTO, interprets Atterberg limits, and computes SPT correlations for engineering properties.

npx playbooks add skill a5c-ai/babysitter --skill soil-classification-tool

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.6 KB

---
name: soil-classification-tool
description: Soil classification skill using USCS and AASHTO systems with SPT correlations
allowed-tools:
  - Read
  - Write
  - Glob
  - Grep
  - Edit
  - Bash
metadata:
  specialization: civil-engineering
  domain: science
  category: Geotechnical Analysis
  skill-id: CIV-SK-013
---

# Soil Classification Tool Skill

## Purpose

The Soil Classification Tool Skill classifies soils using USCS and AASHTO systems, interprets Atterberg limits, and provides SPT correlation calculations for engineering properties.

## Capabilities

- USCS classification
- AASHTO soil classification
- Atterberg limits interpretation
- Grain size distribution analysis
- Soil description generator
- SPT correlation calculations
- Relative density estimation
- Consistency determination

## Usage Guidelines

### When to Use
- Classifying soil samples
- Interpreting laboratory data
- Estimating engineering properties
- Preparing geotechnical reports

### Prerequisites
- Laboratory test data available
- Grain size distribution known
- Atterberg limits tested
- SPT values recorded

### Best Practices
- Follow standard procedures
- Consider local correlations
- Document sample quality
- Verify visual description

## Process Integration

This skill integrates with:
- Geotechnical Site Investigation

## Configuration

```yaml
soil-classification-tool:
  systems:
    - USCS
    - AASHTO
  correlations:
    - SPT-friction-angle
    - SPT-undrained-strength
    - SPT-relative-density
  outputs:
    - classification
    - description
    - properties
```

## Output Artifacts

- Soil classifications
- Property correlations
- Boring logs
- Soil descriptions

Overview

This skill classifies soils using USCS and AASHTO systems, interprets Atterberg limits, and computes SPT-based correlations for engineering properties. It produces concise soil descriptions, recommended classifications, and derived property estimates to support geotechnical reporting. The tool is designed to work from standard lab and field inputs and to integrate into a site investigation workflow.

How this skill works

The skill ingests grain size distributions, Atterberg limits, and SPT blow counts, then applies USCS and AASHTO decision rules to assign classifications. It evaluates liquid limit, plasticity index, and grading curves to interpret consistency and soil behavior. Using established empirical correlations, it translates SPT values into estimates of relative density, friction angle, and undrained strength where appropriate.

When to use it

Classifying soil samples after laboratory grain-size and Atterberg tests
Interpreting SPT field data to estimate engineering properties
Preparing preliminary geotechnical reports and boring logs
Checking consistency and relative density for design input
Converting lab and field results into standard classification outputs

Best practices

Provide complete, quality-controlled lab and field data before running classifications
Use local regional correlations when available and adjust empirical factors accordingly
Document sample disturbance, testing methods, and data uncertainty explicitly
Cross-check automated outputs with a visual description and engineer judgment
Report ranges and confidence levels for correlation-based property estimates

Example use cases

Generate USCS and AASHTO classifications from sieve and Atterberg test files
Estimate friction angle and relative density from SPT blow counts for foundation design
Create a standardized soil description block for a boring log
Assess fines content and plasticity to determine need for soil improvement
Translate lab results into input parameters for slope stability or settlement analyses

FAQ

What inputs are required for reliable classifications?

At minimum provide grain-size distribution, liquid limit, plastic limit, and SPT blow counts; visual descriptions and sample condition improve reliability.

Can SPT correlations be used for cohesive and cohesionless soils?

Yes, but use different empirical relations: SPT-to-relative-density and friction angle are used for cohesionless soils, while SPT-to-undrained-strength correlations apply for cohesive soils; always state uncertainty.