| 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. |
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"