zotoio/CRUX-Utils
.cursor/skills/CRUX-Utils/SKILL.md
Multi-purpose utility for CRUX compression workflows. Provides token estimation and checksum calculation. Use when estimating tokens for compression, comparing file sizes, or getting checksums for sourceChecksum tracking.
$ install --global
skillsauthnpx skillsauth add zotoio/x-fidelity CRUX-UtilsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 10:38 PM9.0s2 files scanned
SKILL.md
- name:
- CRUX-Utils
- description:
- Multi-purpose utility for CRUX compression workflows. Provides token estimation and checksum calculation. Use when estimating tokens for compression, comparing file sizes, or getting checksums for sourceChecksum tracking.
CRUX Utils
Multi-purpose utility for CRUX compression workflows. Provides deterministic tools for token estimation and checksum calculation.
Quick Start
# Token count estimation
bash .cursor/skills/CRUX-Utils/scripts/crux-utils.sh --token-count <file>
# Compare source vs CRUX (ratio mode)
bash .cursor/skills/CRUX-Utils/scripts/crux-utils.sh --token-count --ratio <source> <crux>
# Get checksum for sourceChecksum frontmatter
bash .cursor/skills/CRUX-Utils/scripts/crux-utils.sh --cksum <file>
Modes
--token-count <file>
Estimate token count for a single file.
Output:
=== Token Estimate: example.md ===
Prose tokens: 397
Code tokens: 0
Special tokens: 0
---
TOTAL TOKENS: 397
--token-count --ratio <source> <crux>
Compare source file vs CRUX file and calculate compression ratio.
Output:
=== Compression Ratio Analysis ===
=== Token Estimate: source.md ===
...
=== Token Estimate: source.crux.mdc ===
...
=== Compression Summary ===
Source tokens: 397
CRUX tokens: 140
Ratio: 35.2% of original
Reduction: 64.8%
Target (≤20%): NO
--cksum <file>
Get checksum of a file, formatted for CRUX frontmatter sourceChecksum field.
Output:
=== Checksum: example.md ===
Checksum: 1234567890
---
FRONTMATTER: "1234567890"
Token Estimation Method
| Content Type | Chars/Token | Notes | |--------------|-------------|-------| | Prose (markdown) | 4.0 | English text, headers, lists | | Code blocks | 3.5 | More symbols, shorter identifiers | | Special chars | 1.0 | CRUX Unicode symbols |
Special Characters (1 token each)
CRUX delimiters and symbols that count as 1 token each:
- Delimiters:
« » ⟨ ⟩ - Arrows/flow:
→ ← ≻ ≺ - Logic:
⊤ ⊥ ∀ ∃ ¬ ∋ - Relations:
⊳ ⊲ - Comparison:
≥ ≤ ≠ - Blocks:
Δ Ρ Λ Π Κ Γ Φ Ω - Other:
⊛ ◊ θ
Determinism Guarantee
Both modes produce identical output for identical input:
- No random elements
- No timestamp dependencies
- Pure character/pattern counting
- Consistent across runs
Usage in CRUX Workflow
For compression tasks:
- Get source checksum:
--cksum <source>→ use FRONTMATTER value forsourceChecksum - Estimate source tokens:
--token-count <source>→ use forbeforeTokens - After compression:
--token-count <crux>→ use forafterTokens - Verify ratio:
--token-count --ratio <source> <crux>→ check Target (≤20%)
Related Skills
zotoio/xfi-release-workflow
documentation
VerifiedTrustedCommunity
Guide for managing X-Fidelity releases using the unified release system. Use when releasing, versioning, troubleshooting release issues, or writing commit messages.
1SKILL.mdUpdated Apr 16, 2026
zotoio/xfi-execute-plan
documentation
VerifiedTrustedCommunity
Guide for executing engineering plans through coordinated subagent work. Use when executing existing plans from knowledge/plans/ directory.
1SKILL.mdUpdated Apr 16, 2026
zotoio/xfi-documentation-update
development
VerifiedTrustedCommunity
Guide for updating X-Fidelity documentation including README and website. Use when updating docs, adding new features to documentation, or ensuring docs stay in sync with code.
1SKILL.mdUpdated Apr 16, 2026
zotoio/xfi-debug-analysis
tools
VerifiedTrustedCommunity
Guide for debugging X-Fidelity analysis issues. Use when troubleshooting analysis failures, rule evaluation problems, VSCode extension issues, or unexpected results.
1SKILL.mdUpdated Apr 16, 2026