adopt-repo

Mirror an external repository privately and overlay firmware with privacy sweeping and project initialization.

Updated Aug 30, 2026
One-click install
npx skills add https://github.com/ryanportfolio/threejs-interview-test --skill adopt-repo-ryanportfolio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adopt-repo
Source: https://github.com/ryanportfolio/threejs-interview-test/tree/main/.agents/skills/adopt-repo
Command: npx skills add https://github.com/ryanportfolio/threejs-interview-test --skill adopt-repo-ryanportfolio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Bringing an external upstream repository into a private firmware workflow requires manual cloning, cleanup of template-only files, privacy checks, and project initialization, which is error-prone when done by hand. ## Core Features & Use Cases - Private Mirroring: Clone an upstream repository and mirror it privately under the user's own account. - Template Cleanup and Privacy Sweep: Strip template-only files and run a privacy sweep before adoption. - Project Initialization: Run init-project to overlay the firmware onto the adopted repository. - Use Case: A developer finds a useful open-source starter repo and wants it pulled into their organization's firmware setup; invoking $adopt-repo <url> performs the clone, cleanup, privacy sweep, and initialization in one workflow. ## Quick Start Ask the assistant to adopt an external repository by running $adopt-repo followed by the repository URL, for example to pull that repo into your firmware.

Frequently Asked Questions about adopt-repo

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

FAQPage Schema
How do I adopt an external repository into my firmware?▼

Invoke the skill with $adopt-repo followed by the repository URL, or ask to pull the repo into your firmware. The workflow clones upstream, strips template-only files, runs a privacy sweep, and executes init-project.

What does the adopt-repo workflow do after cloning?▼

After cloning the upstream repository, it strips template-only files, performs a privacy sweep to remove sensitive or unwanted content, and runs init-project to overlay the firmware configuration.

Does adopting a repo automatically commit or push changes?▼

No. Skill invocation alone does not authorize commits, pushes, pull requests, merges, or dependency installation. Those outward actions only happen when explicitly requested by the user.

Can this skill run in Codex instead of Claude Code?▼

Yes. The adapter translates Claude Code tool names to Codex equivalents and applies the compatibility notes in CODEX-SKILL-COMPATIBILITY.md, while keeping the canonical Claude skill workflow unchanged.

What are the limitations of the repo adoption workflow?▼

The workflow depends on the canonical skill definition under .claude/skills/adopt-repo and requires multi-agent tools for any Task or Agent steps. If those tools are unavailable, independent review steps cannot be replaced by self-review.