shogunify

Scaffolds Shogun OS skills, connectors, workflows, and profiles through structured questionnaires.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill shogunify-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shogunify
Source: https://github.com/tapway/shogun-os/tree/main/skills/hermes/shogunify
Command: npx skills add https://github.com/tapway/shogun-os --skill shogunify-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Adding a new skill, connector, cron workflow, or department profile to a Shogun OS / Hermes multi-agent setup involves many error-prone steps: correct profile paths, gbrain-compliant frontmatter, MCP wiring, and index updates. This Skill turns vague "add X" requests into correctly placed, compliant artifacts via a structured interview. ## Core Features & Use Cases - Five authoring modes: integration, provider-only, skill, workflow/cron, and new department profile, each with a dedicated questionnaire. - Profile-aware installation: resolves the correct Hermes home (~/.hermes/skills/ vs ~/.hermes/profiles/<name>/skills/) and symlinks or copies artifacts with install-to-profiles.py. - Compliance enforcement: checklists for SKILL.md frontmatter, department fields, CONTRACT tool naming, cron scoping, and secret handling. - Use Case: Run /shogunify skill leave-balance for hr-manager to interview, scaffold, install, and verify a new HR skill end to end. ## Quick Start Ask the agent to shogunify a new skill named leave-balance for the hr-manager profile and follow the interview prompts.

Frequently Asked Questions about shogunify

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

FAQPage Schema
How do I add a new skill to a Hermes profile?

Run /shogunify skill <name> for <profile> and answer the questionnaire. The skill is scaffolded from templates, installed into ~/.hermes/profiles/<profile>/skills/, and verified as a slash command in a new session.

How do I create a connector or provider for an existing domain?

Use provider-only mode when a CONTRACT already exists for the domain. It generates plugins/<vendor>.py and providers/<vendor>.md, then documents the required env vars in the profile .env and config.yaml MCP env block.

Why is my new slash command not visible on a named profile?

Named profiles only see skills under their own profiles/<name>/skills/ directory; installing to ~/.hermes/skills/ alone is not enough. Symlink or copy the skill with install-to-profiles.py and restart the gateway or start a new session.

Can shogunify create scheduled cron workflows?

Yes, workflow mode creates profile-scoped cron jobs using hermes -p <profile> cron create with a self-contained prompt, optional script, and delivery target. It also updates CRON_INVENTORY.md when shipping to the repo.

When should I not use shogunify?

Skip it for one-off non-reusable operations, pure code bug fixes, or simple config changes. Use systematic-debugging for bugs and direct tools for disposable tasks instead of scaffolding a permanent artifact.