Skip to content
cccskills
FreePublished on GitHub

file-sync

Keep Hermes Worker configuration and shared task files synchronized with MinIO, a central storage service. The skill covers immediate downloads, manual result uploads, and which configuration changes take effect on the next message or require a restart.

OriginalShow the original description

Sync files with centralized storage. Use when your coordinator or another Worker notifies you of file updates (config changes, task files, shared data, collaboration artifacts).

See how to install

Good for

  • Apply newly updated agent settings
  • Retrieve urgent updates to shared task files
  • Upload completed work to MinIO
  • Check whether configuration changes require a restart

Files included (3)

  • SKILL.md2.3 KB
  • scripts/hermes-sync.py4.7 KB
  • scripts/push-shared.sh1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

File Sync (Hermes Worker)

Sync agent config files

When your coordinator notifies you that your config has been updated (e.g., model switch, skill update), trigger an immediate sync:

hermes-sync

This pulls openclaw.json, SOUL.md, AGENTS.md, and skills from MinIO and re-bridges the config into ~/.hermes/ (config.yaml + .env).

Hot reload caveats:

  • Hermes-agent reloads SOUL.md on the next message — no restart needed
  • Skill changes in ~/.hermes/skills/ are picked up on the next message as well
  • Changes that affect config.yaml (model, terminal, matrix behavior) require a process restart — your coordinator handles this when needed

Automatic background sync:

  • Background sync also runs every 300 seconds (5 minutes) as a fallback
  • Most file changes are picked up without manual sync

Sync task / shared files

The shared/ directory is automatically mirrored from MinIO at startup and every sync cycle. No manual pull is needed.

Task and project files are at:

Local path (auto-synced)
shared/tasks/{task-id}/
shared/projects/{project-id}/
# Read the spec (already synced locally)
cat shared/tasks/{task-id}/spec.md

# Push your results back to MinIO (push is still manual)
bash ./skills/file-sync/scripts/push-shared.sh tasks/{task-id}/ --exclude "spec.md" --exclude "base/"

The push-shared.sh script automatically detects your team and pushes to the correct MinIO path.

When to use:

  • When you finish work: push results back to MinIO using push-shared.sh
  • When told files have been updated urgently: run hermes-sync to trigger an immediate pull

Always confirm to the sender after push completes.

Example workflow:

# Coordinator assigns task: "New task [st-01]. Please file-sync and read shared/tasks/st-01/spec.md"
# Run file-sync to pull latest
hermes-sync

# Read the spec
cat shared/tasks/st-01/spec.md

# ... do the work ...

# Push results
bash ./skills/file-sync/scripts/push-shared.sh tasks/st-01/ --exclude "spec.md" --exclude "base/"

# Confirm to coordinator
"Task complete. Results pushed to MinIO."

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Find worker agents in Nacos that match a task, recommend candidates, and import the administrator's chosen worker. It also supports importing a specified nacos package URI, with worker name confirmation and direct reporting of installation failures.

  • Find a suitable worker for an unassigned task
  • Compare Nacos worker candidates before importing
  • Import a worker from a specified nacos package URI
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

Prepare an existing OpenClaw setup for import as an AgentTeams managed Worker. Analyze tool dependencies, adapt role instructions and scheduled jobs, and build a ZIP package containing the configuration and custom image requirements.

  • Moving standalone OpenClaw into AgentTeams
  • Reviewing required tool dependencies
  • Adapting role instructions for a Worker
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

Manage communication channels by identifying senders, maintaining trusted contacts, and setting the administrator's primary notification destination. It also covers first contact on a new channel and contacting the administrator across channels, with rules for handling unknown senders.

  • Identify who sent a message in a room
  • Add or remove trusted contacts
  • Configure the administrator's primary notification channel
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

coding-cli

FreeSummary

Prepare coding tasks for delegation to an authorized agent’s AI command-line tool. Set up and synchronize the workspace, write precise change requests, then review returned changes and run relevant checks before reporting completion.

  • Delegating code implementation or bug fixes to an AI CLI
  • Writing coding requests with clear acceptance criteria
  • Reviewing and testing changes returned by a CLI
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

Run AI coding command-line tools on behalf of worker agents using their prepared prompts and workspaces. Detect available tools, configure delegation, return results, and apply supported execution controls such as time budgets and permission settings.

  • Running coding tools for worker agents
  • Detecting and selecting available coding CLIs
  • Setting Qwen Code permissions and time budgets
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

communication

FreeSummary

Guide agent replies in Matrix chat rooms, including when to mention a coordinator, report completion, raise blockers, or answer questions. The rules limit repetitive acknowledgments and stop exchanges that add no new task, question, or decision.

  • Reporting task completion to a coordinator
  • Raising blockers or questions that need action
  • Reducing repetitive acknowledgments
agentscope-ai/AgentTeams5.8KUpdated Oct 17, 2026

See all skills by agentscope-ai

Report a problem with this skill