hermes-agent/skills/devops/wizard-council-automation/SKILL.md

name, description, version, metadata

name	description	version	metadata
wizard-council-automation	Run wizard environment validation, skills drift audit, and cross-wizard dependency checks — the Wizard Council shared tooling suite	1.0.0	hermes tags related_skills devops wizards environment audit bootstrap

Wizard Council Automation

This skill gives you access to the shared forge tooling for environment validation, skill drift detection, and cross-wizard dependency checking.

Tools

All tools live in wizard-bootstrap/ in the hermes-agent repo root.

1. Environment Bootstrap (wizard_bootstrap.py)

Validates the full wizard environment in one command:

python wizard-bootstrap/wizard_bootstrap.py
python wizard-bootstrap/wizard_bootstrap.py --json

Checks:

• Python version (>=3.11)
• Core dependency imports
• hermes_constants smoke test
• HERMES_HOME existence and writability
• LLM provider API key
• Gitea authentication (GITEA_TOKEN / FORGE_TOKEN)
• Telegram bot connectivity (TELEGRAM_BOT_TOKEN)

Exits 0 if all checks pass, 1 if any fail.

2. Skills Drift Audit (skills_audit.py)

Compares repo-bundled skills against installed skills:

python wizard-bootstrap/skills_audit.py           # detect drift
python wizard-bootstrap/skills_audit.py --fix     # sync missing/outdated
python wizard-bootstrap/skills_audit.py --diff    # show diffs for outdated
python wizard-bootstrap/skills_audit.py --json    # machine-readable output

Reports: MISSING, EXTRA, OUTDATED, OK.

3. Dependency Checker (dependency_checker.py)

Validates binary and env-var dependencies declared in SKILL.md frontmatter:

python wizard-bootstrap/dependency_checker.py
python wizard-bootstrap/dependency_checker.py --skill devops/my-skill

Skills declare deps in their frontmatter:

dependencies:
  binaries: [ffmpeg, imagemagick]
  env_vars: [MY_API_KEY]

4. Monthly Audit (monthly_audit.py)

Runs all three checks and generates a Markdown report:

python wizard-bootstrap/monthly_audit.py
python wizard-bootstrap/monthly_audit.py --post-telegram

Report saved to ~/.hermes/wizard-council/audit-YYYY-MM.md.

Wizard Environment Contract

See wizard-bootstrap/WIZARD_ENVIRONMENT_CONTRACT.md for the full specification of what every forge wizard must maintain.

Workflow

New Wizard Onboarding

1. Clone the hermes-agent repo
2. Install dependencies: uv pip install -r requirements.txt
3. Run: python wizard-bootstrap/wizard_bootstrap.py
4. Resolve all failures
5. Go online

Ongoing Maintenance

1. Monthly audit fires automatically via cron
2. Report posted to wizard-council-automation channel
3. Wizards resolve any drift before next audit

When Drift Is Detected

1. Run python wizard-bootstrap/skills_audit.py to identify drift
2. Run python wizard-bootstrap/skills_audit.py --fix to sync
3. Run python wizard-bootstrap/dependency_checker.py to check deps
4. Update SKILL.md frontmatter with any new binary/env_var requirements