upstream-port

SkillFiles & storage

Port files from a source repo to the-agency, auto path mapping, PR creation

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 upstream-port skill

What this skill tells your AI

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

Upstream Port

Port tools, skills, hookify rules, and docs from a source repo to the-agency framework repo. Auto-maps paths between the two repos.

Arguments

  • $ARGUMENTS: Source file path (relative to repo root), plus optional flags.

Instructions

Step 1: Run the tool

bash $CLAUDE_PROJECT_DIR/agency/tools/upstream-port $ARGUMENTS

Common patterns:

# Port a tool
bash $CLAUDE_PROJECT_DIR/agency/tools/upstream-port agency/tools/flag

# Port a skill (auto-maps commands/X.md → .claude/skills/X/SKILL.md)
bash $CLAUDE_PROJECT_DIR/agency/tools/upstream-port usr/{principal}/commands/flag.md

# Port with auto-merge
bash $CLAUDE_PROJECT_DIR/agency/tools/upstream-port agency/tools/flag --auto-merge

# Port to custom path
bash $CLAUDE_PROJECT_DIR/agency/tools/upstream-port docs/design.md --target agency/docs/design/design.md

Step 2: Verify

The tool creates a PR in the-agency. If --auto-merge was used, it merges immediately. Otherwise, report the PR URL to the user.

Step 3: Create dispatch (optional)

If porting significant work, create a dispatch for the-agency to review:

/dispatch create captain port-<name>

OFFENDERS WILL BE FED TO THE — CUTE — ATTACK KITTENS!

Signals

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