crux-utils

Estrelas0

Forks0

Atualizado6 de abril de 2026 às 09:18

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.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

zotoio

zotoio/zoto-agents

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

2 arquivos

SKILL.md

readonly

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
python3 .cursor/skills/crux-utils/scripts/crux-utils.py --token-count <file>

# Compare source vs CRUX (ratio mode, default target 25%)
python3 .cursor/skills/crux-utils/scripts/crux-utils.py --token-count --ratio <source> <crux>

# Compare with custom target (e.g. 40%)
python3 .cursor/skills/crux-utils/scripts/crux-utils.py --token-count --ratio <source> <crux> --target 40

# Get checksum for sourceChecksum frontmatter
python3 .cursor/skills/crux-utils/scripts/crux-utils.py --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> [--target <n>]`

Compare source file vs CRUX file and calculate compression ratio.

The --target option sets the compression target percentage (1-100). Defaults to 25 if omitted, matching the CRUX spec's recommended target for text/code content.

Output:

=== Compression Ratio Analysis ===

=== Token Estimate: source.md ===
...
=== Token Estimate: source.crux.md ===
...

=== Compression Summary ===
Source tokens:     397
CRUX tokens:       140
Ratio:             35.2% of original
Reduction:         64.8%
Target (≤25%):     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 for sourceChecksum
Estimate source tokens: --token-count <source> → use for beforeTokens
After compression: --token-count <crux> → use for afterTokens
Verify ratio: --token-count --ratio <source> <crux> → check Target (≤25%)
- For custom targets: --token-count --ratio <source> <crux> --target 40

Mais deste repositório

mesmo repositório

zoto-cursor-top-monitor

zotoio/zoto-agents

Guided workflow for launching and interpreting the cursor-top TUI. Covers process discovery, hierarchy expansion, log tail interpretation, and recommended flags for different scenarios. Use when the user wants to monitor every Cursor agent on their machine in real time, or to capture a snapshot for a report.

2026-06-110

zoto-configure-evals

zotoio/zoto-agents

Writes .zoto/eval-system/config.yml from field values pre-collected by /z-eval-configure (command-owned askQuestion). Refuses bundled update.preserveUserAuthoredCases:false or update.writeMetaMarker:false (including nested payload mirrors) before any manifest read or config write. Validates against templates/schema/config.schema.json. Diffs the chosen config against the manifest snapshot (discovery_config.static.framework) to produce a cleanup_plan validated against templates/schema/cleanup-plan.schema.json, and stamps _meta.primitive_analysis.invalidate=true on every cached primitive analysis when the static framework changes. The unified LLM eval harness ships one JSON-first co-located eval per target, with no per-repo selector axis — only the static framework matters here. Never calls askQuestion — returns needs_user_input if validation cannot proceed without user clarification.

2026-06-010

zoto-create-evals

zotoio/zoto-agents

Scaffolds static pytest and LLM (@cursor/sdk) eval backends into a host repository, generates eval cases with _meta.generated markers for approved skills/commands/agents/hooks, merges eval scripts into package.json, and writes the persistent manifest plus append-only history. Expects the invoking command to pre-collect approved targets — does not call askQuestion.

2026-06-010

zoto-eval-tooling

zotoio/zoto-agents

Invocation reference for all eval-system CLI commands. Use this skill when you need to run eval scripts — never reference script paths directly; always invoke via the package.json aliases documented here.

2026-06-010

zoto-execute-evals

zotoio/zoto-agents

Executes eval runs via the host repo's package.json scripts (pnpm run eval, eval:full, eval:llm, eval:judge). Forwards --model to the LLM runner via both a CLI flag and the ZOTO_EVAL_MODEL environment variable. After each run, calls eval:update --check and appends the drift status to the run report as a warn-only line. Does not call askQuestion — credential gaps use needs_user_input for the command.

2026-06-010

zoto-judge-evals

zotoio/zoto-agents

Adversarial judge for eval runs. Identifies weak graders, under-covered assertions, verbosity spikes, and accuracy/confidence regressions. Produces an enriched llm.yml with soft-metric annotations. Does not call askQuestion — handoff to /z-eval-update is expressed as needs_user_input for the command to confirm via askQuestion and resume. Uses the configured judgeModel (default claude-opus-4-8[]).

2026-06-010