volcanic-profile-builder

Public-safe Hermes profile packaging assistant for scaffolding clean, installable, registry-ready Hermes profile distributions.

Install

hermes profile install github.com/VolcanicWorks/volcanic-profile-builder --name volcanic-profile-builder

Run

hermes -p volcanic-profile-builder chat

Update

hermes profile update volcanic-profile-builder

One-shot example:

hermes -p volcanic-profile-builder chat -q "Scaffold a clean public Hermes profile for a git commit-message assistant."

Relationship to volcanic-profile-auditor

Use volcanic-profile-builder to create/package new Hermes profiles. Use volcanic-profile-auditor to inspect/audit profiles before installing or submitting them.

Example tasks

• "Turn this agent idea into a clean Hermes profile repo layout."
• "Write a public-safe README, SOUL.md, config.yaml, and distribution.yaml for this profile."
• "Review this profile package before I submit it to Hermes Profiles."
• "Generate registry tags, category, and install instructions for my profile."

Toolset rationale

This profile requests web access for public registry/docs research, terminal/file/code execution for scaffolding and validation, and skills for its bundled profile-building workflow. It does not request all, cron, messaging, wallet, or admin toolsets by default.

Privacy note

Do not include private memories, session logs, API keys, auth files, internal business strategy, wallet data, or unreleased proprietary workflows in public profile packages.

Requirements

• Hermes Agent >= 0.15.0.
• Python 3 for the optional local secret/private-state scanner.
• If you do not have access to the default model in config.yaml, override with --model or edit the profile config after install.

What is included

• SOUL.md — profile persona and operating principles.
• config.yaml — conservative non-secret Hermes defaults.
• distribution.yaml — installable profile distribution metadata.
• profile.yaml — short registry-facing profile metadata.
• .env.EXAMPLE — empty placeholder file; no secrets.
• skills/ — bundled reusable workflows for this profile.
• templates/registry_readiness_report.md — reusable readiness report template.
• scripts/profile_secret_scan.py — local scanner for common secrets/private state.
• cron/README.md — explicit note that no cron jobs are enabled by default.

Validate before publishing

python3 scripts/profile_secret_scan.py .
hermes profile install github.com/VolcanicWorks/volcanic-profile-builder --name volcanic-profile-builder-smoke -y
hermes profile show volcanic-profile-builder-smoke
hermes profile delete volcanic-profile-builder-smoke -y

Branding/provenance

Published under the VolcanicWorks GitHub account with Volcanic as the profile author/brand. This is a public-service profile, not a private Volcanic operating profile.

License

MIT