cia-data-integration

name	cia-data-integration
description	Expert knowledge in consuming CIA platform JSON exports, validation, caching strategies, and data pipeline integration
license	CC-BY-4.0

CIA Data Integration Skill

🔴 AI FIRST Quality Principle

Apply the AI FIRST principle: never accept first-pass quality. Minimum 2 iterations. Read all output, improve every section. No shortcuts.

Purpose

This skill provides expertise in consuming JSON exports from the CIA (Citizen Intelligence Agency) platform, implementing robust caching strategies, and ensuring data quality through schema validation.

Core Principles

1. CIA is Source of Truth - Never modify CIA's pre-computed data
2. Validate Before Cache - Always validate against CIA-provided JSON schemas
3. Version Tracking - Track all CIA data updates with timestamps
4. Graceful Degradation - Fall back to cached data if CIA unavailable
5. Data Freshness - Monitor and alert on stale data (> 24 hours)
6. Audit Logging - Log all data operations for traceability

Enforces

CIA Export Consumption

• Fetch 19 visualization products from CIA platform
• Handle rate limiting and connection failures
• Implement retry logic with exponential backoff
• Circuit breaker pattern for API failures

JSON Schema Validation

// Validate CIA export against schema
   ;

 ajv =  ({ :  });
 schema =  (productName);
 validate = ajv.(schema);

 (!(data)) {
    (validate.);
}