Agent Skills
› benchflow-ai/skillsbench
› mesh-analysis
mesh-analysis
GitHub用于分析3D STL网格文件的工具，计算体积、连通分量并提取属性。支持噪声过滤以分离主要部件，自动处理二进制STL，并提供材质ID以辅助质量计算，需注意单位一致性。
Trigger Scenarios
需要计算3D模型的体积或几何属性
从扫描数据中过滤噪声并提取主要部件
需要从STL文件中读取材质或颜色属性
Install
npx skills add benchflow-ai/skillsbench --skill mesh-analysis -g -y
SKILL.md
Frontmatter
{
"name": "mesh-analysis",
"description": "Analyzes 3D mesh files (STL) to calculate geometric properties (volume, components) and extract attribute data. Use this skill to process noisy 3D scan data and filter debris."
}
Mesh Analysis
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:
- Geometric Analysis: Calculating volume of complex or noisy meshes.
- Noise Filtering: Isolating the largest connected component from "dirty" scan data.
- 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:
- Read the Material ID from the analysis report.
- Consult your provided material reference data (e.g. density tables) to find the density.
- 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).
Version History
- 9a1f4dd Current 2026-07-24 16:38
