file-sharing

Synchronize shared project and task directories across leader and worker agents.

5.3k|652|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/agentscope-ai/HiClaw --skill file-sharing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-sharing
Source: https://github.com/agentscope-ai/HiClaw/tree/main/manager/agent/team-leader-agent/skills/file-sharing
Command: npx skills add https://github.com/agentscope-ai/HiClaw --skill file-sharing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents broken team collaboration caused by missing or stale files by standardizing how shared directories are referenced and refreshed before Workers act.

Core Features & Use Cases

  • Deterministic shared-path usage: Uses local abstractions like shared/... and global-shared/... so Workers never see storage internals.
  • Correct directory sync boundaries: Requires trailing / for sync paths and distinguishes project/task directory syncing from task-level sync handled by taskflow.
  • Task-ready file contracts: Establishes the team task folder structure (meta.json, spec.md, base/, result.md, workspace/) and clarifies read/write responsibilities between Leader and Worker.
  • Failure-safe behavior: Stops and reports sync failures instead of attempting partial pulls that could corrupt project state.

Quick Start

Tell the Worker to pull shared/task files and then read shared/tasks/{task-id}/spec.md before producing any results.

Frequently Asked Questions about file-sharing

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

FAQPage Schema
How do I synchronize shared project files for team task delegation?

To synchronize shared project files for team task delegation, this Skill coordinates directory syncing across leader and worker agents using strict local path conventions like shared/projects and shared/tasks.

Why do my team workers see stale files during project restarts?

Team workers see stale files during project restarts because the shared storage directories were not refreshed with heartbeat-driven readiness checks before task delegation began.

What is the correct directory sync boundary for shared task folders?

The correct directory sync boundary for shared task folders requires trailing slashes on sync paths to distinguish project directory syncing from task-level sync handled by taskflow.

How do I structure team task folders for worker agent file contracts?

To structure team task folders for worker agent file contracts, create the shared/tasks directory with meta.json, spec.md, base/, result.md, and workspace/ to clarify read and write responsibilities.

What happens when file synchronization fails during task delegation?

When file synchronization fails during task delegation, the process stops and reports the sync failure immediately instead of attempting partial pulls that could corrupt the project state.

Can I use local abstractions to hide storage internals from worker agents?

Yes, you can use local abstractions like shared/... and global-shared/... to hide storage internals from worker agents so they never see the underlying shared storage implementation details.