roman-numerals
Convert roman numerals to integers.
When & Why to Use This Skill
This Claude skill provides a reliable and automated way to convert Roman numerals into base-10 integers. By implementing standard additive and subtractive logic, it helps users accurately decode historical dates, formal document outlines, and academic references, making it an essential utility for education, research, and document processing.
Use Cases
- Academic Support: Assisting students and educators in verifying Roman numeral conversions for history, mathematics, or classical studies.
- Historical Research: Converting dates found on monuments, cornerstones, or archival documents into standard decimal years for easier indexing.
- Document Analysis: Decoding complex outlines, chapter numbers, or volume indices in legal, architectural, or literary texts.
- General Utility: Providing instant translations for Roman numerals found in movie credits, clock faces, or formal event titles (e.g., Super Bowl editions).
| name | roman-numerals |
|---|---|
| description | Convert roman numerals to integers. |
Roman numerals → integer
Use this skill when the user asks you to convert a Roman numeral (e.g., XIV, MCMXCIV) into a base-10 integer.
Output format
Return only the integer as decimal digits (no extra words or punctuation).
Procedure
- Map symbols to values:
I=1,V=5,X=10,L=50,C=100,D=500,M=1000. - Walk left to right:
- If a symbol is followed by a larger symbol, subtract it.
- Otherwise, add it.
- Sum to get the final integer.
Examples
Load examples/skills/roman-numerals/examples/001.md for worked examples and edge cases.