octave-compression

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.
Category: discovered
Tags: github, community
Version: 1.0.0
Author: walid
Downloads: 0
Updated: 2025-11-22
Source: elevanaltd/ingest-assistant
Download the latest version (v1.0.0) from this page.
SKILL.md

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