units
Perform unit conversions and calculations using GNU Units.
When & Why to Use This Skill
The GNU Units skill empowers Claude to perform highly accurate unit conversions and complex scientific calculations. By leveraging the robust GNU Units library, this tool handles thousands of standard, compound, and non-linear units (such as temperature), providing precise numeric results and unit definitions directly within the agent workflow.
Use Cases
- Engineering & Physics: Convert complex compound units like 'miles per hour' to 'meters per second' or calculate force and energy across different measurement systems.
- Global Logistics & Trade: Seamlessly convert shipping weights and dimensions between metric and imperial systems (e.g., kilograms to pounds) for international documentation.
- Scientific Research: Perform precise non-linear temperature conversions (Celsius, Fahrenheit, Kelvin) and large-scale time transformations for experimental data.
- Technical Documentation: Verify unit definitions and ensure consistency in measurement standards across technical manuals and reports.
| name | units |
|---|---|
| description | Perform unit conversions and calculations using GNU Units. |
| metadata | {"clawdbot":{"emoji":"📏","requires":{"bins":["units"]}}} |
GNU Units Skill
Use GNU units to perform unit conversions and calculations via the command line. Can be installed using brew and apt under "units".
Usage
Use the bash tool to run the units command. Use the -t (terse) flag to get just the numeric result.
units -t 'from-unit' 'to-unit'
Examples
Basic Conversion:
units -t '10 kg' 'lbs'
# Output: 22.046226
Compound Units:
units -t '60 miles/hour' 'm/s'
# Output: 26.8224
Temperature (Non-linear):
Temperature requires specific syntax: tempF(x), tempC(x), tempK(x).
units -t 'tempF(98.6)' 'tempC'
# Output: 37
Time:
units -t '2 weeks' 'seconds'
Rounding Output:
To round to specific decimal places (e.g. 3 places), use -o "%.3f":
units -t -o "%.3f" '10 kg' 'lbs'
# Output: 22.046
Definition Lookup:
To see what a unit definition is (without converting), omit the second argument (without -t is more verbose/useful for definitions):
units '1 acre'
Notes
- Currency:
unitssupports currency (USD, EUR, etc.), but exchange rates may be out of date as they are static in the definitions file. - Safety: Always quote your units to prevent shell expansion issues (e.g.
units -t '1/2 inch' 'mm').