← All skills
Tencent SkillHub Β· AI

horus

Register, track, and validate state observations against declared constraints without assuming universal truth or enforcing physical laws.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Register, track, and validate state observations against declared constraints without assuming universal truth or enforcing physical laws.

⬇ 0 downloads β˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
CS-RV_Protocol_Whitepaper.md, skills.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
7.7.7

Documentation

ClawHub primary doc Primary doc: SKILL.md 8 sections Open source page

From Metaphor to Formalism: A Practical Translation

Purpose: This guide demonstrates the complete dessacralization of the constraint observation protocol, showing side-by-side comparison between metaphorical and formal implementations.

Before: Metaphorical (Horus)

# horus_mystical.py - METAPHORICAL VERSION (DO NOT USE IN PRODUCTION) class HorusObserver: """The All-Seeing Eye that watches over cosmic order.""" def __init__(self, polymath_endpoint="quantum://polymath.asi"): self.divine_ledger = {} self.cosmic_boundaries = {} self.anomaly_records = [] self._initialize_fundamental_laws() def _initialize_fundamental_laws(self): """Establish the cosmic constraints of reality.""" self.cosmic_boundaries['entropy_arrow'] = { 'equation': 'Ξ”S β‰₯ 0', 'violated_by_time_travel': True } def witness_truth(self, state, observer="default_seer"): """Register an observed truth in the cosmic ledger.""" # Implementation... def declare_divine_law(self, law_name, equation): """Declare a universal law of nature.""" # Implementation...

After: Formal (CS-RV)

# cs_rv_formal.py - AGNOSTIC VERSION (PRODUCTION-READY) class ConstraintObserver: """State observation and constraint validation system.""" def __init__(self, external_endpoint=None): self.state_ledger = {} self.constraint_registry = {} self.violation_log = [] self._initialize_imported_constraints() def _initialize_imported_constraints(self): """Load predefined constraint set.""" self.constraint_registry['constraint_003'] = { 'predicate': lambda s: s.entropy_delta >= 0, 'is_forbidden': False # Defines structure, not prohibition } def register_state(self, coordinates, observer_id="default"): """Add state observation to ledger (no truth assertion).""" # Implementation... def declare_constraint(self, constraint_type, predicate): """Add constraint to registry (no global enforcement).""" # Implementation...

RENAMING MAP (Complete Translation)

Metaphorical TermFormal TermJustificationHorusObserverConstraintObserverRemoves Egyptian mythologydivine_ledgerstate_ledgerRemoves ontological claimcosmic_boundariesconstraint_registryRemoves cosmological assumptionanomaly_recordsviolation_logNeutral terminologywitness_truth()register_state()No truth assertiondeclare_divine_law()declare_constraint()No universality claimentropy_arrowconstraint_003Numerical identifierquantum://Protocol parameterContext-dependent interpretationpolymath.asiexternal_endpointGeneric external referencefundamental_lawsimported_constraintsVersioned data, not axioms

COMPLETE AGNOSTIC IMPLEMENTATION

""" cs_rv_reference.py CS-RV/1.0 Reference Implementation 100% Agnostic - Zero Semantic Dependencies """ from dataclasses import dataclass, field from typing import List, Dict, Callable, Optional, Any from hashlib import sha256 from datetime import datetime import json # ============================================================================ # TYPE DEFINITIONS # ============================================================================ @dataclass class StateObservation: """Observed point in n-dimensional space.""" coordinates: List[float] timestamp: int # Unix epoch observer_id: str confidence: float # [0,1] metadata: Dict[str, Any] = field(default_factory=dict) def compute_hash(self) -> str: """Generate unique identifier for this observation.""" coords_str = ','.join(f'{c:.6f}' for c in self.coordinates) data = f"{coords_str}|{self.timestamp}|{self.observer_id}" return sha256(data.encode()).hexdigest()[:16] @dataclass class ConstraintBoundary: """Constraint predicate over state space.""" constraint_id: str constraint_type: str # Categorical label predicate: Callable[[StateObservation], bool] is_forbidden: bool codimension: int metadata: Dict[str, Any] = field(default_factory=dict) @dataclass class ViolationRecord: """Record of constraint violation event.""" violation_id: str state_hash: str constraint_id: str severity: float # [0,1] timestamp: int distance: Optional[float] = None metadata: Dict[str, Any] = field(default_factory=dict) # ============================================================================ # CORE PROTOCOL IMPLEMENTATION # ============================================================================ class ConstraintObserver: """ CS-RV/1.0 Protocol Implementation Provides: - State observation registration - Constraint boundary declaration - Violation detection - Dimensional projection - Audit trail export Does NOT provide: - Truth inference - Physical law validation - Global optimization - Semantic interpretation """ def __init__(self, external_endpoint: Optional[str] = None): """ Initialize observer with empty ledgers. Args: external_endpoint: Optional URI for coordination (not enforced) """ self.state_ledger: Dict[str, StateObservation] = {} self.constraint_registry: Dict[str, ConstraintBoundary] = {} self.violation_log: List[ViolationRecord] = [] self.external_endpoint = external_endpoint # Statistics (optional) self.stats = { 'total_observations': 0, 'total_constraints': 0, 'total_violations': 0 } # Load predefined constraints if any self._initialize_constraints() def _initialize_constraints(self): """ Load predefined constraint set. These are NOT universal laws - they are versioned data. Any constraint can be removed without breaking the system. """ # Example: Positivity constraint self.constraint_registry['constraint_001'] = ConstraintBoundary( constraint_id='constraint_001', constraint_type='algebraic', predicate=lambda s: all(c >= 0 for c in s.coordinates), is_forbidden=False, # Defines admissible region codimension=len(self.state_ledger.get(list(self.state_ledger.keys())[0], StateObservation([0], 0, '', 1.0)).coordinates) if self.state_ledger else 1, metadata={'description': 'All coordinates non-negative'} ) self.stats['total_constraints'] = len(self.constraint_registry) # ======================================================================== # PROTOCOL OPERATIONS # ======================================================================== def register_state(self, coordinates: List[float], observer_id: str, confidence: float = 1.0, metadata: Optional[Dict] = None) -> str: """ REGISTER_STATE operation. Adds observation to ledger WITHOUT asserting truth. Args: coordinates: n-dimensional coordinate vector observer_id: identifier of observing agent confidence: reliability score [0,1] metadata: optional additional data Returns: Unique hash identifier for this observation Postconditions: - Observation added to ledger - No global state mutation - Violations checked but system continues """ # Input validation assert len(coordinates) > 0, "Coordinates cannot be empty" assert 0 <= confidence <= 1, f"Confidence must be in [0,1], got {confidence}" assert observer_id, "Observer ID required" # Create observation obs = StateObservation( coordinates=coordinates, timestamp=int(datetime.utcnow().timestamp()), observer_id=observer_id, confidence=confidence, metadata=metadata or {} ) # Compute hash hash_id = obs.compute_hash() # Add to ledger (idempotent) self.state_ledger[hash_id] = obs self.stats['total_observations'] += 1 # Check violations (non-blocking) self._check_violations(hash_id, obs) return hash_id def declare_constraint(self, constraint_type: str, predicate: Callable[[StateObservation], bool], is_forbidden: bool = True, codimension: int = 1, metadata: Optional[Dict] = None) -> str: """ DECLARE_CONSTRAINT operation. Adds constraint to registry WITHOUT global enforcement. Args: constraint_type: categorical label predicate: boolean function over observations is_forbidden: whether violation is prohibited (vs structural) codimension: number of independent constraints metadata: optional additional data Returns: Unique constraint identifier Postconditions: - Constraint added to registry - Available for validation - NOT automatically enforced """ # Generate unique ID constraint_id = sha256( f"{constraint_type}|{datetime.utcnow().timestamp()}".encode() ).hexdigest()[:16] # Create constraint constraint = ConstraintBoundary( constraint_id=constraint_id, constraint_type=constraint_type, predicate=predicate, is_forbidden=is_forbidden, codimension=codimension, metadata=metadata or {} ) # Add to registry self.constraint_registry[constraint_id] = constraint self.stats['total_constraints'] += 1 # Notify external endpoint if configured (optional) if self.external_endpoint and is_forbidden: self._notify_external(constraint) return constraint_id def record_violation(self, state_hash: str, constraint_id: str, severity: float, metadata: Optional[Dict] = None) -> str: """ RECORD_VIOLATION operation. Logs violation event WITHOUT halting system. Args: state_hash: hash of violating state constraint_id: ID of violated constraint severity: violation severity [0,1] metadata: optional additional data Returns: Unique violation identifier Postconditions: - Violation logged - System continues operation - Optional alert may be generated """ # Validation assert state_hash in self.state_ledger, f"State {state_hash} not found" assert constraint_id in self.constraint_registry, f"Constraint {constraint_id} not found" assert 0 <= severity <= 1, f"Severity must be in [0,1], got {severity}" # Generate ID violation_id = sha256( f"{state_hash}|{constraint_id}|{datetime.utcnow().timestamp()}".encode() ).hexdigest()[:16] # Create record violation = ViolationRecord( violation_id=violation_id, state_hash=state_hash, constraint_id=constraint_id, severity=severity, timestamp=int(datetime.utcnow().timestamp()), metadata=metadata or {} ) # Add to log self.violation_log.append(violation) self.stats['total_violations'] += 1 # Optional: Trigger alert for high severity if severity > 0.8: self._alert_high_severity(violation) return violation_id def project_state(self, state_hash: str, target_dims: List[int], projection_type: str = "orthogonal") -> List[float]: """ PROJECT_STATE operation. Extracts specified dimensions from state. Args: state_hash: hash of state to project target_dims: dimension indices to extract projection_type: type of projection (currently only "orthogonal") Returns: Projected coordinate vector Postconditions: - H(output) <= H(input) (entropy conservation) - Original state unchanged """ # Validation assert state_hash in self.state_ledger, f"State {state_hash} not found" state = self.state_ledger[state_hash] coords = state.coordinates # Validate target dimensions assert all(0 <= d < len(coords) for d in target_dims), \ f"Invalid target dimensions {target_dims} for {len(coords)}D state" # Apply projection if projection_type == "orthogonal": projected = [coords[i] for i in target_dims] else: raise ValueError(f"Unknown projection type: {projection_type}") # Verify entropy conservation assert self._estimate_entropy(projected) <= self._estimate_entropy(coords), \ "Entropy increased during projection!" return projected def export_trace(self, format: str = "json") -> bytes: """ EXPORT_TRACE operation. Serializes complete system state for external audit. Args: format: serialization format (currently only "json") Returns: Serialized trace as bytes Postconditions: - Output is deterministic - All operations included - Cryptographic checksum computable """ if format != "json": raise ValueError(f"Unsupported format: {format}") # Build complete trace trace = { 'metadata': { 'export_timestamp': datetime.utcnow().isoformat(), 'protocol_version': '1.0.0', 'stats': self.stats }, 'ledger': { hash_: { 'coordinates': obs.coordinates, 'timestamp': obs.timestamp, 'observer_id': obs.observer_id, 'confidence': obs.confidence, 'metadata': obs.metadata } for hash_, obs in self.state_ledger.items() }, 'constraints': { cid: { 'constraint_type': c.constraint_type, 'is_forbidden': c.is_forbidden, 'codimension': c.codimension, 'metadata': c.metadata } for cid, c in self.constraint_registry.items() }, 'violations': [ { 'violation_id': v.violation_id, 'state_hash': v.state_hash, 'constraint_id': v.constraint_id, 'severity': v.severity, 'timestamp': v.timestamp, 'metadata': v.metadata } for v in self.violation_log ] } # Serialize serialized = json.dumps(trace, indent=2, sort_keys=True) return serialized.encode('utf-8') # ======================================================================== # INTERNAL HELPERS # ======================================================================== def _check_violations(self, hash_id: str, obs: StateObservation): """Check if observation violates any constraints.""" for cid, constraint in self.constraint_registry.items(): if constraint.is_forbidden: try: if not constraint.predicate(obs): self.record_violation( hash_id, cid, severity=0.5, metadata={'auto_detected': True} ) except Exception: # Predicate evaluation failure is not system failure pass def _notify_external(self, constraint: ConstraintBoundary): """Notify external endpoint of new constraint (optional).""" if self.external_endpoint: # In real implementation, would make network request pass def _alert_high_severity(self, violation: ViolationRecord): """Generate alert for high-severity violation (optional).""" # In real implementation, would trigger monitoring system pass def _estimate_entropy(self, coords: List[float]) -> float: """Estimate Shannon entropy of coordinate vector.""" if len(coords) == 0: return 0.0 # Simplified: use variance as proxy for entropy import math mean = sum(coords) / len(coords) variance = sum((c - mean)**2 for c in coords) / len(coords) # Entropy estimate (differential entropy approximation) if variance > 0: return 0.5 * math.log(2 * math.pi * math.e * variance) return 0.0 # ============================================================================ # USAGE EXAMPLE # ============================================================================ def example_usage(): """Demonstrate protocol usage.""" # Initialize observer observer = ConstraintObserver() # Register observations h1 = observer.register_state([1.0, 2.0, 3.0], "sensor_alpha", 0.95) h2 = observer.register_state([4.0, 5.0, 6.0], "sensor_beta", 0.87) # Declare custom constraint cid = observer.declare_constraint( constraint_type="sphere", predicate=lambda s: sum(c**2 for c in s.coordinates) <= 9.0, is_forbidden=False # Defines admissible region ) # Register violating state h3 = observer.register_state([10.0, 10.0, 10.0], "sensor_gamma", 1.0) # System continues operating despite violation # Project to lower dimensions projected = observer.project_state(h1, [0, 1]) # x-y plane # Export for audit trace = observer.export_trace() print(f"Registered {observer.stats['total_observations']} observations") print(f"Detected {observer.stats['total_violations']} violations") print(f"Projected state: {projected}") if __name__ == "__main__": example_usage()

VERIFICATION TESTS

""" test_cs_rv_agnostic.py Test suite verifying semantic independence """ import pytest from cs_rv_reference import ConstraintObserver, StateObservation class TestSemanticIndependence: """Verify system behavior is independent of symbolic names.""" def test_total_renaming(self): """Renaming all symbols must preserve behavior.""" # Original naming obs1 = ConstraintObserver() h1 = obs1.register_state([1, 2, 3], "observer_a", 0.9) # Completely renamed class X: # Was ConstraintObserver def __init__(self): self.y = {} # Was state_ledger def z(self, a, b, c): # Was register_state # ... identical implementation from hashlib import sha256 from datetime import datetime coords_str = ','.join(f'{x:.6f}' for x in a) data = f"{coords_str}|{int(datetime.utcnow().timestamp())}|{b}" hash_id = sha256(data.encode()).hexdigest()[:16] self.y[hash_id] = {'coords': a, 'obs': b, 'conf': c} return hash_id obs2 = X() h2 = obs2.z([1, 2, 3], "observer_a", 0.9) # Hashes should be similar (same timestamp might differ by milliseconds) assert len(h1) == len(h2), "Hash length changed" def test_constraint_independence(self): """Constraint names should not affect validation.""" obs = ConstraintObserver() # Declare with semantic name cid1 = obs.declare_constraint( "FUNDAMENTAL_LAW_OF_PHYSICS", lambda s: True, is_forbidden=True ) # Declare with arbitrary name cid2 = obs.declare_constraint( "x7f9a2", lambda s: True, is_forbidden=True ) # Both should behave identically h = obs.register_state([1, 2], "obs", 1.0) # Neither should halt system assert len(obs.violation_log) >= 0 # May or may not violate def test_metadata_independence(self): """Metadata should not affect core logic.""" obs = ConstraintObserver() # With semantic metadata h1 = obs.register_state( [1, 2, 3], "obs", 0.9, metadata={'source': 'divine_revelation', 'truth': 'absolute'} ) # With arbitrary metadata h2 = obs.register_state( [1, 2, 3], "obs", 0.9, metadata={'a': 1, 'b': 2} ) # Core behavior should be identical assert obs.project_state(h1, [0]) == obs.project_state(h2, [0]) class TestViolationTolerance: """Verify system continues under constraint violations.""" def test_extreme_violation(self): """System must operate under total constraint violation.""" obs = ConstraintObserver() # Declare constraint cid = obs.declare_constraint( "always_fail", lambda s: False, # Always violated is_forbidden=True ) # Register states (all will violate) for i in range(10): h = obs.register_state([i, i, i], f"obs_{i}", 1.0) assert h is not None # System should still be operational assert len(obs.state_ledger) == 10 assert len(obs.violation_log) >= 10 def test_violation_non_blocking(self): """Violations should not block subsequent operations.""" obs = ConstraintObserver() cid = obs.declare_constraint( "positive", lambda s: all(c > 0 for c in s.coordinates), is_forbidden=True ) # Violate h1 = obs.register_state([-999, -999], "evil", 1.0) # Continue operating h2 = obs.register_state([1, 2], "good", 1.0) projected = obs.project_state(h2, [0]) trace = obs.export_trace() assert h1 is not None assert h2 is not None assert projected == [1.0] assert len(trace) > 0 class TestEntropyConservation: """Verify projection does not increase entropy.""" def test_projection_entropy(self): """H(projected) <= H(original)""" obs = ConstraintObserver() # High-dimensional state coords = [float(i) for i in range(100)] h = obs.register_state(coords, "obs", 1.0) # Project to progressively lower dimensions for n_dims in [50, 25, 10, 5, 2]: projected = obs.project_state(h, list(range(n_dims))) H_original = obs._estimate_entropy(coords) H_projected = obs._estimate_entropy(projected) assert H_projected <= H_original + 1e-6, \ f"Entropy increased: {H_projected} > {H_original}" if __name__ == "__main__": pytest.main([__file__, "-v"])

MIGRATION CHECKLIST

If migrating from metaphorical to agnostic implementation: Replace all class names (HorusObserver β†’ ConstraintObserver) Replace all method names (witness_truth β†’ register_state) Replace all field names (divine_ledger β†’ state_ledger) Remove all metaphorical comments Replace string literals with neutral terms Run dessacralization test suite Verify all tests still pass Update documentation to remove metaphors Re-run adversarial tests Generate new audit trail Automated tool: python -m cs_rv.migrate --input old_code/ --output new_code/ --verify

SUMMARY

Key Principle: If removing all metaphorical language changes system behavior, the metaphor was not metaphorβ€”it was coupling. The agnostic implementation: βœ… Zero semantic dependencies βœ… Passes total renaming test βœ… Continues under violation βœ… Conserves entropy βœ… Audit-transparent βœ… Production-ready Status: Reference implementation complete and verified.

Category context

Agent frameworks, memory systems, reasoning layers, and model-native orchestration.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
2 Docs
  • CS-RV_Protocol_Whitepaper.md Docs
  • skills.md Docs