Jewish Hebrew Text Tools

Hebrew text processing utilities: transliteration, gematria calculation, nikud removal, letter identification, and Hebrew number formatting. Pure Python, no...

Security Scan

The package implements the claimed Hebrew text utilities and contains no network/credential access, but there are coherence problems (CLI/install and Python import mismatches plus minor code bugs) that make the bundle unreliable and worth closer inspection before use.

Purpose & Capability

The name/description match the provided code: transliteration, gematria, nikud removal, letter naming, and number formatting are implemented in the included Python file. However, the SKILL.md expects a CLI named 'hebrew-tools' and a Python import path 'scripts.hebrew_tools', while the provided file is named 'scripts/hebrew-tools.py' (hyphen). That filename prevents importing as a Python module and also there is no install spec to expose a 'hebrew-tools' command on PATH. These mismatches are coherence issues (likely typos or missing install steps) but not direct evidence of malicious intent.

Instruction Scope

Runtime instructions and examples are narrowly scoped to text processing and do not request files, environment variables, or external endpoints. The code likewise performs only local string processing. The SKILL.md's examples assume a CLI and Python API that are not actually importable/installed given the included filename, which is an inconsistency in runtime expectations.

Install Mechanism

There is no install spec (instruction-only), which is low-risk. The package includes a single Python script; no downloads, external packages, or install hooks are specified. The main concern is that the SKILL.md assumes an installed CLI/module but no mechanism to create one is provided.

Credentials

No environment variables, credentials, or config paths are requested. The code does not access network, files beyond stdin/stdout, or environment variables, so requested privileges are proportionate to the stated purpose.

Persistence & Privilege

The skill does not request always:true and does not modify agent/system configurations. Autonomous invocation is allowed by default (platform normal), but the skill itself does not request elevated persistence.

What to consider before installing

This skill appears to implement the claimed Hebrew text utilities and does not request credentials or network access, but there are mismatches and minor code issues you should address before trusting it: (1) SKILL.md shows a CLI 'hebrew-tools' and a Python import 'scripts.hebrew_tools', yet the included file is 'scripts/hebrew-tools.py' (hyphen). That prevents importing as a module and means the CLI won't be on PATH unless you install/rename it. (2) The transliteration mapping has duplicate/conflicting entries (e.g., 'ת' appears more than once) and some heuristic code checks that look buggy; outputs may be incorrect. Recommended actions: review the source locally, run it in an isolated environment (container or sandbox), rename the file to a valid module name (hebrew_tools.py) or call it directly with 'python scripts/hebrew-tools.py', and validate outputs on test cases you control. Do not provide any credentials (none are needed) and avoid executing unreviewed code on sensitive systems.

Hebrew Text Tools

Pure Python utilities for Hebrew text processing. No dependencies, works offline.

Quick Start

# Transliterate Hebrew to Latin
hebrew-tools "שלום עולם"
# Output: shalom olam

# Calculate gematria
hebrew-tools -g "בראשית"
# Output: 913

# Remove nikud (vowel points)
echo "שָׁלוֹם" | hebrew-tools -n
# Output: שלום

# List letter names
hebrew-tools -l "אבג"
# Output: Alef, Bet, Gimel

# Format number as Hebrew letters
hebrew-tools -N 613
# Output: תרי"ג

Commands

Command	Description	Example
hebrew-tools <text>	All transformations	hebrew-tools "שלום"
hebrew-tools -t <text>	Transliterate only	hebrew-tools -t "תורה" → "torah"
hebrew-tools -g <text>	Gematria only	hebrew-tools -g "חי" → 18
hebrew-tools -n <text>	Remove nikud	hebrew-tools -n "בְּרֵאשִׁית" → "בראשית"
hebrew-tools -l <text>	Letter names	hebrew-tools -l "אב" → [Alef, Bet]
hebrew-tools -r <text>	Reverse RTL	hebrew-tools -r "שלום" → "מולש"
hebrew-tools -N <num>	Number to letters	hebrew-tools -N 26 → "כו"

Output Format (Default)

original: שלום
has_hebrew: True
transliteration: shalom
no_nikud: שלום
gematria: 376
letter_names: [Shin, Lamed, Vav, Mem]

Features

Transliteration

• Ashkenazi-style pronunciation
• Handles all Hebrew letters including sofit (final forms)
• Shin/Sin distinction (dot right/left)
• Dagesh handling

Gematria

• Standard Mispar Hechrachi values
• Supports all Hebrew letters including sofit forms
• Works with or without nikud

Nikud Removal

• Removes all Hebrew vowel points and cantillation marks
• Preserves base letters
• Handles composite characters

Letter Names

• Returns English names for each Hebrew letter
• Sofit forms identified (e.g., "Mem Sofit")
• Non-Hebrew characters preserved

Hebrew Number Formatting

• Converts integers to Hebrew letters (Gematria style)
• Standard abbreviations (e.g., תרי"ג for 613)
• Range: 1–999

Python API

from scripts.hebrew_tools import transliterate, gematria, remove_nikud

# Transliterate
print(transliterate("תורה"))  # "torah"

# Gematria
print(gematria("חי"))  # 18

# Remove nikud
clean = remove_nikud("בְּרֵאשִׁית")
print(clean)  # "בראשית"

Limitations

• Transliteration is Ashkenazi-style; Sephardi variants not yet supported
• Hebrew number formatting only supports 1–999
• RTL reversal is basic (word-level, not character-level for mixed text)