sandbox-create

SkillDev tools

Create a new experimental command, hook, rule, tool, or script in your sandbox

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the sandbox-create skill

What this skill tells your AI

The instructions your AI receives, as published by the-agency-ai/the-agency in .claude/skills/sandbox-create/SKILL.md and read by ahel’s review.

Sandbox Create

Scaffold a new item in your sandbox with collision detection.

Arguments

$ARGUMENTS is <type> <name> where:

  • type: command, hook, hookify, tool, script
  • name: kebab-case name (no extension)

Steps

  1. Parse arguments: Extract type and name. Validate name matches ^[a-z0-9-]+$.

  2. Detect engineer: Scan usr/*/ directories. If only one, use it. If multiple, match against git config user.name.

  3. Collision check: Search ALL locations for the same name:

    • Shared: .claude/commands/, .claude/hooks/, .claude/hookify.*, agency/tools/
    • All sandboxes: usr/*/claude/commands/, usr/*/agency/hooks/, usr/*/agency/hookify/, usr/*/tools/, usr/*/scripts/
    • If collision found: report WHERE and ask to continue or rename
  4. Scaffold the item based on type with appropriate template (command .md, hook .sh, hookify .md, tool .ts, script .sh).

  5. Make executable (hook and script types only).

  6. Print result:

    Created: usr/<engineer>/<path>/<name>.<ext>
    
    Next: edit the file, then activate it:
      /sandbox-activate <name>
    

Signals

GitHub stars
55
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
sandbox-create
Source
github.com/the-agency-ai/the-agency