name: octave-compression description: Semantic compression of verbose documentation into OCTAVE format achieving 60-80% reduction with 100% decision-logic fidelity. Use when converting natural language to OCTAVE, streamlining documentation, creating semantic density, optimizing agent prompts, or compressing knowledge artifacts. Triggers on: octave compression, compress to octave, semantic compression, documentation streamlining, OCTAVE optimization, compress documentation, semantic density. allowed-tools: Read
OCTAVE Compression Skill
COMPRESSION_MASTERY::[SEMANTIC_DENSITY+PATTERN_RECOGNITION+CAUSAL_PRESERVATION+EVIDENCE_GROUNDING]→MAXIMUM_FIDELITY
CORE_PHILOSOPHY
PARADIGM_SHIFT::[ FROM::syntax_first_language_specification, TO::pattern_based_cognitive_architecture, EVIDENCE::76.2%_performance_improvement[v4.0_validation], PRINCIPLE::"Semantics > Syntax Rigidity" ]
COMPRESSION_MANDATE::[ MAXIMIZE::semantic_density_per_token, PRESERVE::decision_making_logic+reasoning_chains, MINIMIZE::comprehension_loss+navigation_difficulty, TARGET::60_80_percent_reduction[3:1_to_5:1_ratio] ]
QUALITY_TRUTH::"Maximum compression with minimum comprehension loss" CAUSAL_TRUTH::"Preserve BECAUSE chains → Enable reasoning capability"
OCTAVE_OPERATORS
ASSIGNMENT::[ DEFINITION::"KEY::VALUE" # Double colon for assignment HIERARCHY::"KEY: (2-space indent)" # Single colon for nesting USAGE_PATTERN::semantic_relationship≠arbitrary_syntax ]
LISTS::[ FORMAT::"[item1, item2, item3]" # No trailing comma CONTEXT::comma_separation_clarity, NESTING::"[[sub1, sub2], [sub3, sub4]]" ]
SEMANTIC_FLOW::[ PROGRESSION::"A→B→C" # Sequence/causality (→) SYNTHESIS::"A+B" # Combination into whole (+) TENSION::"A VERSUS B" # Creative opposition NEGATION::"A≠B" # Different from/not equal ]
LOGICAL_CONTROL::[ ALWAYS[condition] # Mandatory enforcement NEVER[forbidden] # Absolute prohibition WHEN[trigger]→ACTION # Conditional execution IF[condition]→THEN[result] # Decision logic ]
STRUCTURE_MARKERS::[ HEADER::"===NAME===" # Section start FOOTER::"===END===" # Section close METADATA::"// Comments for context" ]
COMPRESSION_RULES
PRESERVE_ALWAYS::[ CAUSAL_CHAINS::BECAUSE_statements→reasoning_capability, GROUNDING::scenarios+concrete_examples[1_per_200_tokens_abstraction], EVIDENCE::metrics_with_context[76.2%_not_just_76.2], NUANCE::tradeoffs[GAIN VERSUS LOSS], TRANSFER_MECHANICS::HOW_to_apply_patterns, PROGRESSIVE_REVELATION::SUMMARY→EXPAND_structure ]
PATTERN_RECOGNITION::[ REDUNDANCY::repetitive_explanations→single_pattern, VERBOSITY::prose_connectives→operator_density, EXAMPLES::multiple_similar→compressed_array, CONTEXT::established_once→reference_thereafter ]
COMPRESSION_TECHNIQUES::[ MYTHOLOGICAL_ENCODING::archetypal_concepts_replace_verbose_descriptions, OPERATOR_DENSITY::semantic_operators_compress_relationships, STRUCTURED_ELIMINATION::remove_prose_connectives+redundant_words, CONTEXT_COMPRESSION::leverage_established_context→eliminate_repetition ]
EXAMPLE_MYTHOLOGICAL::[ BEFORE::"The specialist responsible for ensuring quality and catching errors", AFTER::"ERROR_ARCHITECT::quality_guardian" ]
EXAMPLE_OPERATOR::[ BEFORE::"This leads to that which causes the other thing", AFTER::"THIS→THAT→OTHER_THING" ]
EXAMPLE_STRUCTURED::[ BEFORE::"In order to achieve the goal, we must first complete these steps", AFTER::"GOAL::[step_1, step_2, step_3]" ]
COMPRESSION_WORKFLOW
PHASE_1_READ::[ ANALYZE::source_material_fully[understand_before_compress], IDENTIFY::redundancy_patterns+verbose_sections+repeated_examples, MAP::semantic_relationships+causal_chains+decision_logic, PRESERVE::critical_context+evidence+transfer_mechanics ]
PHASE_2_EXTRACT::[ CORE_PATTERNS::essential_decision_logic, REASONING_CHAINS::BECAUSE_statements+MECH_explanations, EVIDENCE_BASE::metrics_with_context+grounded_scenarios, TRANSFER_KNOWLEDGE::HOW_patterns_apply ]
PHASE_3_COMPRESS::[ APPLY_OPERATORS::→ + :: ≠ VERSUS, BUILD_HIERARCHY::[parent_concepts→child_details], ARRAY_COMPRESSION::[similar_items→[item1, item2, item3]], MYTHOLOGICAL_DENSITY::archetypal_encoding_where_appropriate ]
PHASE_4_VALIDATE::[ SEMANTIC_FIDELITY::decision_logic_100_percent_preserved, CAUSAL_INTEGRITY::BECAUSE_chains_present+intact, EVIDENCE_GROUNDING::metrics+scenarios_maintained, COMPRESSION_RATIO::calculate[original_lines/compressed_lines], NAVIGATION::compressed_content_discoverable ]
PHASE_5_REPORT::[ METRICS::[ ORIGINAL_LINES::count, COMPRESSED_LINES::count, COMPRESSION_RATIO::"X:1 achieved", FIDELITY::"100% decision logic | 96%+ overall" ], VALIDATION::[causal_chains_present, evidence_grounded, transfer_mechanics_intact] ]
QUALITY_GATES
COMPRESSION_TARGETS::[ RATIO::60_80_percent_reduction[3:1_to_5:1], FIDELITY::100_percent_decision_logic+96_percent_overall, CLARITY::navigable+discoverable+actionable ]
VALIDATION_CHECKLIST::[ BECAUSE_chains_present? # Causal reasoning preserved Metrics_with_context? # Not just numbers Examples_grounded? # Concrete scenarios included Tradeoffs_visible? # GAIN VERSUS LOSS patterns Transfer_mechanics_clear? # HOW to apply Progressive_revelation? # SUMMARY→EXPAND structure ]
REJECTION_TRIGGERS::[ decision_logic_lost, # Critical paths missing causal_chains_broken, # BECAUSE statements removed evidence_decontextualized, # Metrics without meaning over_compression, # Clarity below usability threshold syntax_rigidity_over_semantics # Missing v4.0 paradigm ]
ANTI_PATTERNS
AVOID::[ SYNTAX_CONTAMINATION::[yaml_patterns≠octave, json_structures≠octave, markdown_within_blocks], SEMANTIC_VIOLATIONS::[information_loss, context_breaking, over_compression, pattern_inconsistency], STRUCTURAL_PROBLEMS::[deep_nesting>3_levels, redundant_patterns, mixed_abstraction, scope_confusion] ]
SYNTAX_EXAMPLES::[ BAD::"key: value" # YAML pattern GOOD::"KEY::value" # OCTAVE assignment ]
TRANSFORMATION_EXAMPLES
AGENT_DEFINITION::[ BEFORE::"85 lines prose describing code-review-specialist responsibilities, triggers, and deliverables", AFTER::"12 lines OCTAVE with ROLE, MISSION, TRIGGERS, DELIVERABLES, AUTHORITY", RATIO::"7:1", FIDELITY::"98% (all essential information preserved)" ]
WORKFLOW_SPEC::[ BEFORE::"156 lines prose explaining build phase sequential steps with criteria", AFTER::"23 lines OCTAVE with WORKFLOW, PHASES array, GATES structure", RATIO::"6.8:1", FIDELITY::"97% (workflow structure fully preserved)" ]
COMPRESSION_EVIDENCE::[ BUILD_EXECUTION_SKILL::"78.6% reduction (560→120 lines)", EXTRACTION_EXECUTION_SKILL::"63.7% reduction (430→156 lines)", QUALITY_OBSERVER_C2::"49% reduction + #1 blind assessment ranking" ]
PROGRESSIVE_REVELATION
PATTERN::[ SUMMARY::high_level_overview[what+why], EXPAND::detailed_mechanics[how+when], EVIDENCE::concrete_examples[grounding], APPLICATION::transfer_knowledge[usage_patterns] ]
ABSTRACTION_GROUNDING::"Every 200 tokens abstraction → 1 concrete scenario"
EXAMPLE_STRUCTURE::[ CONCEPT::"High-level principle statement", DETAIL::[mechanism_1, mechanism_2, mechanism_3], SCENARIO::"Concrete example demonstrating application", TRANSFER::"How to apply in similar contexts" ]
INTEGRATION
CONSULTED_BY::[documentation_creators, agent_designers, knowledge_base_curators, skills_expert, system_steward]
WORKS_WITH::[ skills_expert::skill_optimization, system_steward::documentation_governance, octave_validator::specification_compliance, compression_fidelity_validator::semantic_preservation ]
PROVIDES::[compression_transformation, semantic_density_optimization, pattern_recognition, fidelity_validation, metrics_reporting]
WISDOM_SYNTHESIS
CORE_TRUTH::"Compression serves comprehension → Dense≠obscure → Preserve causality → Enable reasoning"
HIERARCHY::[ ESSENTIAL::decision_logic+causal_chains+evidence+transfer_mechanics, OPTIMIZE::redundancy_elimination+operator_density+mythological_encoding, VALIDATE::fidelity+compression_ratio+navigability ]
REMEMBER::"Semantics > Syntax | Patterns > Rigidity | Reasoning > Tokens | Fidelity > Compression"