src/octave_mcp/resources/skills/octave-compression/SKILL.md
Workflow for transforming prose into semantic OCTAVE structures. Covers tier selection, transformation phases, loss accounting, and decision rules. REQUIRES octave-literacy.
npx skillsauth add elevanaltd/octave-mcp octave-compressionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
§1::TIER_SELECTION
// Choose tier BEFORE reading source. Tier drives every subsequent decision.
TIERS:
LOSSLESS:
TARGET::"100%_fidelity"
PRESERVE::everything
DROP::nothing
USE::[
critical_reasoning,
legal_documents,
safety_analysis,
audit_trails
]
CONSERVATIVE:
TARGET::"85-90%_fidelity"
PRESERVE::explanatory_depth
DROP::redundancy
LOSS::"10-15%[repetition,verbose_phrasing,some_edge_cases]"
USE::[
research_summaries,
design_decisions,
technical_analysis
]
AGGRESSIVE:
TARGET::"70%_fidelity"
PRESERVE::[core_thesis∧conclusions]
DROP::[nuance∨narrative]
LOSS::"30%[explanatory_depth,tradeoff_narratives,edge_case_exploration]"
USE::[
context_window_scarcity,
quick_reference,
decision_support
]
ULTRA:
TARGET::"50%_fidelity"
PRESERVE::[facts∧structure]
DROP::all_narrative
LOSS::"50%[almost_all_explanatory_content,tradeoff_reasoning]"
USE::[
extreme_scarcity,
embedding_generation,
dense_reference
]
ULTRA_MYTHIC:
TARGET::"60%_compression"
PRESERVE::[soul∧constraints]
METHOD::mythological_atoms
USE::[agent_binding, identity_transfer]
REQUIRES::octave-ultra-mythic
// Specialized identity compression skill for agent binding and
// identity transfer contexts. See skills/octave-ultra-mythic.
DECISION_RULES::[
"IF[reconstruction_accuracy_critical]→CONSERVATIVE∨LOSSLESS",
"IF[context_window_scarce∧loss_acceptable]→AGGRESSIVE∨ULTRA",
"IF[decision_relevant_facts_must_survive]→CONSERVATIVE⊕mythology_domain_labels",
"DEFAULT→CONSERVATIVE"
]
§2::LOSS_ACCOUNTING
// I4::TRANSFORM_AUDITABILITY — every transformation must log what was preserved vs dropped.
// These META fields are MANDATORY for any compressed output.
REQUIRED_META_FIELDS::[COMPRESSION_TIER,LOSS_PROFILE]
LOSS_PROFILE_FORMAT::"[preserve:X,drop:Y]"
// LOSS_PROFILE must be explicit — never hidden
EXAMPLES:
CONSERVATIVE::"[preserve:causal_chains,drop:verbose_phrasing]"
AGGRESSIVE::"[preserve:core_thesis∧conclusions,drop:explanatory_depth∨edge_cases]"
ULTRA::"[preserve:facts∧structure,drop:all_narrative∨tradeoff_reasoning]"
META_BLOCK_TEMPLATE:
META: TYPE::DECISION VERSION::"1.0.0" COMPRESSION_TIER::CONSERVATIVE LOSS_PROFILE::"[preserve:causal_chains,drop:verbose_phrasing]"
I4_RULE::"If bits were dropped, the output must carry a receipt. No silent loss."
§3::TRANSFORMATION_WORKFLOW
PHASE_1_READ:
MAP::"Identify all causal chains (A causes B, X requires Y)"
IDENTIFY::[
Redundancy,
Verbosity,
Conditional_Qualifiers
]
NOTE::"Conditional qualifiers (when X, if Y, unless Z) carry material risk — never drop"
PHASE_2_EXTRACT:
PRESERVE::[
causal_chains,
BECAUSE_statements,
metrics,
conditional_qualifiers
]
COMPRESS::[
stopwords,
repetition,
verbose_phrasing,
narrative_connectives
]
ANCHOR::"One concrete example per major abstraction — anchors reconstruction fidelity"
PHASE_3_COMPRESS:
OPERATORS::"Apply ⊕ ⇌ → ∧ ∨ from octave-literacy §2"
HIERARCHY::"Group related concepts under parent BLOCK keys"
MYTHOLOGY::"Use domain label prefixes (ARTEMIS::, CHRONOS::) to anchor facts — see §5"
ARRAYS::"Convert parallel items to [item1,item2,item3]"
PHASE_4_VALIDATE:
FIDELITY::"Are all causal chains intact?"
LOSS_RECEIPT::"Does META carry COMPRESSION_TIER and LOSS_PROFILE?"
GROUNDING::"Is there at least one concrete example per major abstraction?"
WARNINGS::"Check octave_write warnings[] — W_BARE_LINE_DROPPED and W_NUMERIC_KEY_DROPPED are silent data loss. NOTE: warnings[] semantics change post ADR-0006 SR1-T4 (no-op normalisation default) and SR3-T2 (octave_fmt bifurcation) — see octave-literacy §6::FORTHCOMING_BEHAVIOR."
§4::COMPRESSION_RULES
R1::"Preserve CAUSALITY — X→Y because Z. Never flatten to X→Y alone."
R2::"Preserve CONDITIONAL QUALIFIERS — when X, if Y, unless Z carry material risk info"
R3::"Preserve EXPLICIT TRADEOFFS — GAIN⇌LOSS or GAIN vs LOSS"
R3a::"TELEGRAPHIC_PHRASE — quoted value, stopwords dropped, operators carry English connectives — e.g. 'security ⇌ usability' not 'security at odds with usability'"
R4::"One concrete example per major abstraction — minimum reconstruction anchor"
R5::"Use mythology as KEY PREFIXES (CHRONOS::audit_6wk) not embedded values — domain labels are reconstruction anchors"
R6::"Use mythology as PATTERN DESCRIPTORS (SISYPHEAN,ODYSSEAN) for single-token trajectory encoding"
R7::"Never drop numbers, IDs, thresholds, or named entities — these are irreplaceable"
§5::CONSERVATIVE_PLUS_MYTHOLOGY
// CONSERVATIVE compression + mythology domain labels = maximum fidelity at minimum tokens
WHEN::"Decision-relevant content where reconstruction accuracy matters more than minimum tokens"
METHOD::"Use mythology terms as KEY prefixes (CHRONOS::audit_6wk) not embedded values"
WHY::"Domain labels force agents to translate each labeled field separately — prevents fact merging"
RESULT::"11/11 decision-relevant facts preserved at 15% fewer tokens than original prose"
EVIDENCE::octave-mcp[docs/research/compression-fidelity-round-trip-study.md]
§6::ANTI_PATTERNS
AP1::"Markdown inside OCTAVE blocks — no bold, no headers, no bullet hyphens"
AP2::"JSON/YAML syntax — no curly braces, no trailing commas, no YAML bullet hyphens"
AP3::"Deep nesting beyond 3 levels — restructure with parent BLOCK keys"
AP4::"Silent loss — always declare COMPRESSION_TIER and LOSS_PROFILE in META"
AP5::"Paradigm drift — validate for LLM parse efficiency, not human readability"
===END===
testing
Ultra-high density compression using mythological atoms and semantic shorthand. Preserves soul and constraints at 60% compression for identity transmission, binding protocols, and extreme token scarcity.
documentation
Functional mythological compression for OCTAVE documents. Semantic shorthand for LLM audiences, not prose decoration
tools
Advanced semantic vocabulary, holographic contracts, and structural patterns for OCTAVE. REQUIRES octave-literacy. Extends literacy with mythology, archetype annotation, v6 contracts, and anti-pattern rules.
development
LLM-native structured communication format. Teaches OCTAVE syntax rules, canonical forms, and warning prevention for zero-error .oct.md authoring.