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 instructions are consistent with its stated purpose (STL parsing, component analysis, volume and attribute extraction); it does not request credentials, install anything, or contact external endpoints.

Purpose & Capability

Name/description match the provided code and SKILL.md. The bundle includes a single Python module that parses binary and ASCII STL files, extracts the 2-byte attribute, performs connected-component grouping, and computes volumes — all coherent with 'mesh-analysis'. No unrelated binaries, credentials, or config paths are requested.

Instruction Scope

SKILL.md contains concrete usage examples that only load the included script and operate on a local STL file. Instructions do not ask the agent to read unrelated files, environment variables, or send data externally. The hard-coded sys.path example points to the skill install location (expected for instruction-only skills).

Install Mechanism

There is no install spec (instruction-only plus an included script). Nothing is downloaded or written to arbitrary locations by an installer. The risk surface is limited to the provided Python file being executed in the agent environment.

Credentials

The skill requests no environment variables, no credentials, and no config paths. That is proportional for a local file-processing utility.

Persistence & Privilege

The skill is not marked always:true and does not attempt to modify other skills or system-wide settings. It runs only when invoked and does not require persistent elevated privileges.

Assessment

This skill appears coherent and limited to local STL processing. Before installing: (1) Inspect and run the script in a controlled environment if you process untrusted files (malformed or extremely large STLs can cause resource issues); (2) validate the tool's assumptions for units and material/attribute semantics against your data (SKILL.md warns about units); (3) be aware the module reads files from disk — ensure you only pass files you intend the agent to access. If you need production-grade robustness, consider additional validation of input files and unit tests for volume calculations and component detection.

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).