sandbox-adopt

Move sandbox files to shared locations with symlink cleanup and version control staging.

39|6|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/the-agency-ai/the-agency --skill sandbox-adopt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sandbox-adopt
Source: https://github.com/the-agency-ai/the-agency/tree/main/.claude/skills/sandbox-adopt
Command: npx skills add https://github.com/the-agency-ai/the-agency --skill sandbox-adopt

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables engineers to efficiently share sandbox files with the team by moving items into shared locations, reducing manual management and cleanup of symlinks.

Core Features & Use Cases

  • Item Migration: Finds and relocates sandbox items to designated shared directories.
  • Symlink Cleanup: Removes all symlinks to the item across the sandbox to prevent broken links.
  • Use Case: If an engineer develops a feature branch, they can adopt relevant files to the team shared folder to facilitate collaboration and reuse.

Quick Start

Use the sandbox adopt skill to transfer a specific file or directory from an engineer’s sandbox into the team’s shared workspace, ensuring all symlinks are cleaned and the shared version is staged in version control.

Frequently Asked Questions about sandbox-adopt

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

FAQPage Schema
How do I move files from an individual sandbox to a shared team directory?

To move files from an individual sandbox to a shared team directory, you can automate the relocation of specific items while simultaneously cleaning up related symlinks. This ensures the shared workspace receives the updated files safely for team collaboration.

Why do I need to clean up symlinks when sharing sandbox files with a team?

Cleaning up symlinks is necessary when sharing sandbox files to prevent broken links across the development environment. Removing all symlinks to the relocated item ensures that team members access the correct shared version instead of dead local references.

What is the best way to stage shared sandbox files in version control?

The best way to stage shared sandbox files in version control is to automate the migration process to handle relocation and symlink cleanup simultaneously. This safely stages the shared file in version control during the transfer to the team workspace.

Can I use this sandbox migration approach for experimental feature branches?

Yes, you can use this sandbox migration approach for experimental feature branches. It is specifically designed for collaborative development environments where engineers need to seamlessly adopt and share experimental or project files into the team folder.

What happens to existing local symlinks after a sandbox file is adopted into shared storage?

After a sandbox file is adopted into shared storage, all existing local symlinks pointing to that item are automatically removed. This symlink cleanup prevents broken paths and ensures the shared file is updated safely without leaving dead links behind.