mesh-analysis

Analyzes 3D mesh files (STL) to calculate geometric properties (volume, components) and extract attribute data. Use this skill to process noisy 3D scan data...

Security Scan

The skill's code and runtime instructions match its stated purpose (STL parsing, component extraction, volume and attribute extraction); it performs only local file parsing and math with no network, credential, or install requirements.

Purpose & Capability

Name and description (STL mesh analysis, volume, components, attribute extraction) match the included Python module which parses Binary/ASCII STL, extracts the 2-byte attribute, computes connected components and volume. No unrelated capabilities or credentials are requested.

Instruction Scope

SKILL.md instructs the agent to add a hard-coded skill path (/root/.claude/skills/mesh-analysis/scripts) to sys.path and import the module; otherwise instructions stay within the stated purpose and only operate on user-supplied STL files. The absolute path assumption is environment-specific and may fail outside the expected runtime.

Install Mechanism

No install spec or external downloads are present. The skill is instruction-only with a small included Python script; nothing is fetched from the network or written to system locations during install.

Credentials

The skill requests no environment variables, credentials, or config paths and the code does not read secrets or external configuration. It only reads the STL file path provided by the user.

Persistence & Privilege

always is false and the skill does not modify other skills, system settings, or persist credentials. It runs as a regular imported module operating on files the user supplies.

Assessment

This skill appears coherent and limited to local STL parsing and geometry calculations. Before installing, consider: 1) you are running third‑party Python code locally—run in a sandbox if you don't fully trust the publisher; 2) the SKILL.md shows a hard-coded agent path that may not match your environment; 3) the tool assumes the STL attribute bytes hold material IDs and that volume units match your density table—verify units before computing mass; 4) supply only STL files you intend to process (large or malformed files may cause errors). Otherwise there are no network calls, secret requests, or other red flags.

This skill provides the MeshAnalyzer tool for robustly processing 3D STL files. It handles Binary STL parsing and connected component analysis.

When to Use

Use this skill for:

1. Geometric Analysis: Calculating volume of complex or noisy meshes.
2. Noise Filtering: Isolating the largest connected component from "dirty" scan data.
3. Attribute Extraction: Extracting metadata (e.g. material IDs) stored in the STL file attribute bytes.

Usage

The tool is provided as a Python module in the scripts/ directory.

Basic Workflow

import sys
# Add skill path to sys.path
sys.path.append('/root/.claude/skills/mesh-analysis/scripts')

from mesh_tool import MeshAnalyzer

# Initialize with file path
analyzer = MeshAnalyzer('/path/to/your/file.stl')

# Analyze specific components
# Automatically identifies the largest component (main part)
report = analyzer.analyze_largest_component()

volume = report['main_part_volume']
mat_id = report['main_part_material_id']

print(f"Volume: {volume}")
print(f"Material ID: {mat_id}")

Calculating Mass

The tool provides the Volume and Material ID. To calculate Mass:

1. Read the Material ID from the analysis report.
2. Consult your provided material reference data (e.g. density tables) to find the density.
3. Calculate: Mass = Volume * Density.

Critical Note on Units:

• The Volume returned is in the same units as the STL file's coordinates (cubed).
• Do not assume millimeters or inches. Check your task instructions for the coordinate system units (e.g., if coordinates are in cm, volume is in cm³).
• If your density table uses the same unit (e.g., g/cm³ and cm³), multiply directly. No unit conversion is needed.

Critical Notes

• Binary Support: The tool automatically handles Binary STL files.
• Attribute extraction: The tool extracts the 2-byte attribute stored in the binary STL format (often used for color or material ID).