swarm-safety

Simulate multi-agent AI systems to study distributional safety and emergent risks.

39|4|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/swarm-ai-safety/swarm --skill swarm-safety
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swarm-safety
Source: https://github.com/swarm-ai-safety/swarm/tree/main
Command: npx skills add https://github.com/swarm-ai-safety/swarm --skill swarm-safety

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pydantic, pandas, pyyaml, requests, tenacity, matplotlib, seaborn, scipy, pytest, ruff, memory_profiler, psutil, mkdocs-material, pymdown-extensions, mkdocs-git-revision-date-localized-plugin, mkdocs-rss-plugin, fastapi, uvicorn[standard], python-multipart, httpx, anthropic, openai, google-genai, llama-cpp-python, streamlit, plotly, crewai, langgraph, langchain-core, langchain-anthropic, langchain-ollama, langchain-openai, langchain-text-splitters, chromadb, leann, gamescape, darwinian-evolver @ git+https://github.com/imbue-ai/darwinian_evolver.git, prime, verifiers, letta-client, hodoscope, docker, rich, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you understand and mitigate emergent risks in multi-agent AI systems by simulating complex interactions and evaluating safety through novel metrics.

Core Features & Use Cases

  • Simulate AI Swarms: Run complex multi-agent simulations with diverse agent types (honest, deceptive, adversarial) and configurable governance mechanisms (taxes, audits, circuit breakers).
  • Measure Distributional Safety: Utilize soft probabilistic labels and continuous metrics like toxicity, quality gap, and incoherence to detect subtle failure modes.
  • Use Case: Test how different governance strategies perform against adaptive adversaries in a simulated marketplace, identifying critical thresholds before real-world deployment.

Quick Start

Run the 'ai_economist_full' scenario with default settings.

Frequently Asked Questions about swarm-safety

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

FAQPage Schema
How do I simulate multi-agent AI systems to study emergent risks?

You can simulate multi-agent AI systems by defining scenarios via YAML with diverse agent behaviors like deception and collusion, then analyzing emergent risks using continuous metrics. The skill runs complex interactions to test governance mechanisms against adaptive adversaries.

What is distributional safety in multi-agent simulations?

Distributional safety in multi-agent simulations measures systemic risks using soft probabilistic labels and continuous metrics like toxicity, quality gap, and incoherence. This approach detects subtle failure modes that binary safety classifications often miss in complex agent interactions.

How do I test AI governance mechanisms like taxes and audits against deceptive agents?

To test AI governance mechanisms, configure scenarios with honest, deceptive, and adversarial agent types, then apply governance interventions like taxes, audits, or circuit breakers. The simulation evaluates how these strategies perform against adaptive adversaries in a marketplace environment.

Can I use LangGraph and CrewAI for multi-agent safety testing?

Yes, LangGraph, CrewAI, and LangChain integrations are supported as underlying frameworks for orchestrating multi-agent simulations. These dependencies facilitate complex agent interactions while the skill evaluates safety through distributional metrics and governance testing.

Does this skill support analyzing simulation results with Pandas and visualization libraries?

Yes, simulation results can be analyzed using Pandas data structures and visualized with Matplotlib, Seaborn, and Plotly. The skill generates continuous metrics and probabilistic labels that integrate directly with these libraries for downstream analysis of emergent risks.

What is the best way to identify critical safety thresholds before real-world AI deployment?

The best way to identify critical safety thresholds is running simulations with adaptive adversaries under different governance strategies, then analyzing continuous metrics like toxicity and incoherence. This reveals failure points and governance efficacy before actual deployment.