the-agency-ai/src/claude/skills/upstream-port
src/claude/skills/upstream-port/SKILL.md
Port files from a source repo to the-agency — auto path mapping, PR creation
$ install --global
skillsauthnpx skillsauth add the-agency-ai/the-agency src/claude/skills/upstream-portInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 11:37 AM118.9s1 file scanned
SKILL.md
- description:
- Port files from a source repo to the-agency — auto path mapping, PR creation
<!--
Flag #62/#63: allowed-tools removed. Inherits Bash(*) from
.claude/settings.json. Restricting to specific subcommand patterns at the
skill level silently blocks agents on permission prompts the agent cannot
see — see dispatch #171 for the devex incident that surfaced this trap.
-->
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!
Related Skills
the-agency-ai/src/claude/skills/worktree-sync
business
VerifiedTrustedCommunity
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-list
tools
VerifiedTrustedCommunity
List all git worktrees with status info (branch, clean/dirty, deps)
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-delete
tools
VerifiedTrustedCommunity
Remove a git worktree and optionally delete its branch
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-create
development
VerifiedTrustedCommunity
Create a new git worktree with dedicated branch and bootstrapped dev environment
5SKILL.mdUpdated Apr 22, 2026