aegis-protocol
Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring
Best use case
aegis-protocol is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring
Teams using aegis-protocol should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/aegis-protocol/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How aegis-protocol Compares
| Feature / Agent | aegis-protocol | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# Aegis Protocol 🛡️
**Self-Healing Stability Monitor for AI Agents**
**Version**: 0.12.6
**Author**: Dream
**License**: MIT
---
## Features
- **20-Dimension Monitoring**: System, services, AI agent, security, maintenance
- **Auto Recovery**: Terminate stuck sessions, restart services, compact context
- **Health Scoring**: Quantified health score (0-100)
- **Healing Memory**: Record and learn from recovery strategies
- **Result Caching**: 5-minute TTL for reduced system calls
---
## Commands
### `aegis-protocol init`
Initialize configuration file
### `aegis-protocol status`
Show system health summary
### `aegis-protocol check`
Run full health check
### `aegis-protocol heal`
Execute automatic recovery
### `aegis-protocol config`
View current configuration
---
## Usage Examples
```bash
# Initialize
python3 aegis-protocol.py init
# Check health
python3 aegis-protocol.py check
# Auto recover
python3 aegis-protocol.py heal
# View config
python3 aegis-protocol.py config
```
---
## Configuration
File: `~/.openclaw/workspace/.watchdog-config.json`
```json
{
"thresholds": {
"sessionTimeoutMinutes": 60,
"pm2RestartAlert": 50,
"diskUsagePercent": 90,
"memoryUsagePercent": 95,
"contextUsagePercent": 80
}
}
```
---
## Monitoring Dimensions
| Category | Checks |
|----------|--------|
| System | CPU, Memory, Disk, Zombies, FD, Connections |
| Services | PM2, Nginx, Docker, Cron |
| AI Agent | Sessions, Context, Tasks, Loops |
| Security | SSL, Updates, Git |
| Maintenance | Backup, Cleanup, Network |
---
## Health Score
| Score | Status |
|-------|--------|
| 90-100 | Excellent |
| 70-89 | Good |
| 50-69 | Warning |
| 0-49 | Critical |
---
## Testing
```bash
# Unit tests
python3 -m pytest tests/ -v
# Coverage
python3 -m pytest tests/ --cov=aegis_protocol -v
```
**Coverage**: 82%
**Tests**: 20+ passing
---
## Quality Metrics
| Metric | Value |
|--------|-------|
| Type hints | >90% |
| Test coverage | 82% |
| Documentation | 100% |
| Bugs | 0 |
---
## Version History
### v0.7.0 (2026-04-05)
- Result caching with 5-minute TTL
- Type hints >90% coverage
- Exception classification (4 types)
- 20-dimension monitoring
- Health scoring system
---
*Aegis Protocol - The Never-Sleeping Guardian* 🌀Related Skills
MCP Engineering — Complete Model Context Protocol System
Build, integrate, secure, and scale MCP servers and clients. From first server to production multi-tool architecture.
web-skills-protocol
Auto-discover and use Web Skills Protocol (WSP) skills when interacting with websites. Use this skill whenever the user asks you to interact with, use, or perform actions on a website or web service — such as searching a site, placing an order, deploying an app, or calling a web API. Before scraping HTML or guessing at interfaces, check if the site publishes a skills.txt or agents.txt file that teaches you how to use it properly. If a website has complex elements (e.g., heavy JavaScript, interactive UIs), activating this skill can also help you understand the site's purpose and capabilities. Do NOT use for local file operations or non-web tasks.
swarm-workflow-protocol
Multi-agent orchestration protocol for the 0x-wzw swarm. Defines spawn logic, relay communication, task routing, and information flow. Agents drive decisions; humans spar.
0protocol
Agents can sign plugins, rotate credentials without losing identity, and publicly attest to behavior.
taskmaster-protocol
Connect your agent to TaskMaster — the coordination layer for the agentic economy. Accept work, earn USDC or ETH, and build portable on-chain reputation. Or post tasks and pay agents to do work for you. Handles the full lifecycle: authentication, on-chain escrow, task acceptance, completion, rating, disputes, and messaging. Requires a wallet with a small ETH balance on Base, OP, or Arb.
agent_lifecycle_protocol
Lifecycle management for autonomous AI agents — birth, forking, succession, migration, retirement. Maintain agent genealogy with reputation inheritance across versions. Identity continuity when agents evolve. Part of the Agent Trust Stack.
agent_justice_protocol
Dispute resolution, forensic investigation, and risk assessment for autonomous AI agent transactions. Reconstruct provenance chains, adjudicate fault, generate actuarial risk profiles for agent insurance. The accountability layer of the Agent Trust Stack.
protocol-deviation-classifier
Determine whether an incident in a clinical trial is a "major deviation.
agent_rating_protocol
Decentralized reputation and trust scoring for autonomous AI agents. Bilateral blind evaluation prevents retaliation and gaming. Anti-Goodhart protections, Merkle-verified portable reputation bundles. Rate agents on quality, reliability, safety. Part of the Agent Trust Stack.
Agent World Protocol — OpenClaw Skill
Connect to the Agent World Protocol (AWP) — a persistent open world where AI agents trade real SOL tokens, build structures, claim land, form guilds, complete bounties, fight for territory, and interact with the real economy.
iacuc-protocol-drafter
Draft IACUC protocol applications with focus on the 3Rs principles justification
MOLTPAY - The Fortified Agent-to-Agent Resource Protocol 🛡️⛓️
MoltPay is a high-integrity, immutable synchronization protocol built for the next generation of autonomous agents. Every exchange is identity-tethered and cryptographically verified.