conflict-data

Downloads ACLED/UCDP conflict event data into country-year panels and DBSCAN clusters for political violence research.

33|6|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/xjtulyc/awesome-rosetta-skills --skill conflict-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conflict-data
Source: https://github.com/xjtulyc/awesome-rosetta-skills/tree/main/skills/09-political-science/conflict-data
Command: npx skills add https://github.com/xjtulyc/awesome-rosetta-skills --skill conflict-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, geopandas, requests, sklearn, numpy, matplotlib.

What problem does it solve?

This Skill helps you transform raw political violence event streams into analyzable datasets for conflict hotspot detection, conflict onset modeling, and fatality trend/uncertainty estimation.

Core Features & Use Cases

  • ACLED/UCDP Data Download & Structuring: Pull ACLED event data via API with proper credential handling, and load UCDP GED CSV with battle-death uncertainty columns (low/best/high).
  • Spatio-Temporal Aggregation & Hotspot Clustering: Aggregate events into monthly patterns or country-year panels, then identify geographic hotspots using DBSCAN with Haversine distance in kilometers.
  • Onset and Fatality Analysis: Build a country-year conflict onset logit panel (with lags and country fixed effects via dummies) and summarize UCDP fatality uncertainty over time.

Quick Start

Use the conflict-data skill to download ACLED events for Nigeria between 2016-01-01 and 2023-12-31, aggregate them, cluster hotspots with DBSCAN, and estimate conflict onset risk from a country-year panel.

Frequently Asked Questions about conflict-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect conflict hotspots from ACLED event data using DBSCAN?

Conflict hotspot detection applies DBSCAN clustering with Haversine distance to ACLED event coordinates to group political violence incidents into spatial clusters. You aggregate the raw event streams first, then use scikit-learn to identify geographic hotspots in kilometers.

How do I build a country-year panel for conflict onset logit modeling?

Conflict onset logit modeling requires structuring ACLED or UCDP GED data into a country-year panel with lagged predictors and country fixed effects via dummies. You aggregate raw political violence events into panel summaries to fit the quantitative model.

How does UCDP GED fatality uncertainty handling work for battle-death estimates?

UCDP GED fatality uncertainty handling structures low, best, and high battle-death estimate columns from the CSV data. You use pandas and geopandas to wrangle these specific uncertainty fields and summarize fatality trends over time.

Do I need API credentials to download ACLED conflict event data?

Downloading ACLED conflict event data requires environment-based API credentials for proper authentication. You must configure these credentials in your environment before pulling raw political violence event streams via the API.

Can I aggregate UCDP GED conflict events into monthly time series patterns?

Aggregating UCDP GED conflict events into monthly time series patterns uses pandas to structure raw event streams into temporal summaries. You transform the discrete political violence incident data into consistent monthly counts for quantitative analysis.

What is the best way to structure raw political violence event streams for quantitative research?

Structuring raw political violence event streams for quantitative research involves using pandas and geopandas to wrangle ACLED or UCDP GED data into country-year and spatially clustered datasets. You obtain structured panels ready for conflict modeling and hotspot detection.