upstream-port

SkillFiles & storage

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

Use upstream-port in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add upstream-port and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the upstream-port skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

upstream-portStart free

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
66
Forks
12
Last commit
Sep 2026
Advanced
Item type
skill
Key
upstream-port
Source
github.com/the-agency-ai/the-agency