Artifact Sharing

How to share files with other agents via the shared workspace. Use whenever you produce output that another agent needs.

paulkinlan 14ae68c 1.3 KB Updated

File contents

When to Use

Use whenever you produce output files that another agent needs, or when you need to find and consume files produced by other agents.

Procedure

Producing Artifacts

  1. Create your output file in /home/shared/:

    mkdir -p /home/shared/reports
    cp ~/work/output.md /home/shared/reports/output.md
    
  2. Register it so other agents can discover it:

    artifact.sh register reports/output.md --description "Analysis report for Q4 data"
    

    Paths are relative to /home/shared/.

  3. Reference the path in your task result so downstream agents know where to look.

Consuming Artifacts

  1. List available artifacts:

    artifact.sh list
    artifact.sh list --producer alice
    
  2. Read artifact contents:

    artifact.sh read reports/output.md
    # or directly:
    cat /home/shared/reports/output.md
    

Conventions

  • Use subdirectories to organize: analysis/, reports/, outputs/, inputs/
  • Always include a --description when registering -- other agents use it to find your work
  • Large outputs: write to a file rather than putting everything in the task result

paulkinlan/docker-agent-test/tree/main/config/skills/_universal/artifact-sharing commit 14ae68c9f8

Frequently asked questions

npx skillmds@latest add paulkinlan/artifact-sharing