skills.rest
Speculative
SpeculativeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

add-project

Create a project branch from an external GitHub repository with subtree integration and pyproject.toml dependency setup.

Updated Dec 4, 2025
Search Tags:#automation#git#python#github#branch-management#dev-dependencies#subtree
One-click install
npx skills add https://github.com/Speculative/debugging-study --skill add-project-speculative
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-project
Source: https://github.com/Speculative/debugging-study/tree/main/.claude/skills/add-project
Command: npx skills add https://github.com/Speculative/debugging-study --skill add-project-speculative

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates creating a dedicated project branch from an external GitHub repository, providing a clean baseline for debugging work.

Core Features & Use Cases

  • Create a new project branch from an external repository and attach it as a git subtree under a specified prefix.
  • Automatically set up development dependencies in a root pyproject.toml or prepare a new one with a dev group and UV source for local tooling.
  • Commit changes and outline next steps to propagate updates and create bug branches from the baseline.

Quick Start

Invoke /add-project and provide the project name, GitHub repository URL, and the branch to create a new project branch from the external repository.

Frequently Asked Questions about add-project

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

FAQPage Schema
How do I create a project branch from an external GitHub repository?▼

You can create a project branch from an external GitHub repository by invoking the add-project command with the project name, repository URL, and branch. This attaches the external repo as a git subtree under a specified prefix.

What is git subtree integration used for when setting up a debugging baseline?▼

Git subtree integration incorporates an external GitHub repository into a local project branch to establish a clean, isolated debugging baseline. This allows you to manage external dependencies directly within your main repository.

Do I need pyproject.toml to set up development dependencies for a new project branch?▼

Yes, pyproject.toml is required for dependency management. The automation modifies an existing root pyproject.toml or creates a new one, configuring a dev group and UV source to install local tooling for the project branch.

Can I automate git branch management and dependency setup for bug-fix challenges?▼

Yes, you can automate git branch management and dependency setup for bug-fix challenges. The process provisions a baseline project branch with subtree integration and dev dependencies, serving as a seed for future work.

What are the limitations of using git subtree for external repository management?▼

Limitations of using git subtree for external repository management include requiring subprocess controls and a local git installation. The approach targets provisioning baseline project branches rather than handling continuous bidirectional syncing across multiple repositories.

Related Skills

Explore More Software Engineering Skills→
chiubakachiubaka
1

org-subtree-sync

Synchronize a local org subtree with an upstream repository using git subtree pull.

Community
Intermediate
dboskdbosk
1

git-commit-practices

Enforce atomic commits on feature branches in git repositories.

Community
Basic
the-perfect-developerthe-perfect-developer
11

python-uv

Manage Python projects with uv for initialization, dependencies, and environments.

Community
Intermediate
ojowwalker77ojowwalker77
110

Clone Repo

Shallow clone external repositories into a temporary directory and optionally check out a branch.

Community
Intermediate