skills.rest
heman1033p-create
heman1033p-createCOMMUNITY
Explore all skills by this author →
GitHub

project

Clone, track, and manage external GitHub repositories using ghq and symlinks.

Updated Feb 28, 2026
Search Tags:#git#github#repository management#clone#project lifecycle#symlink#ghq
One-click install
npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill project-heman1033p-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project
Source: https://github.com/heman1033p-create/cv-v2-kongphop/tree/main/.gemini/skills/project
Command: npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill project-heman1033p-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing many external repositories for study or development leads to scattered clones, duplicated copies, and lost track of where projects live. This Skill centralizes all clones under ghq and organizes them with symlinks into learn (read-only study) and incubate (active development) workspaces, maintaining a single source of truth. ## Core Features & Use Cases - Learn & Incubate: Clone any GitHub repo via ghq and symlink it into an organized owner/repo structure for study or active development, with workflow flags like --contribute and --flash for PR-driven contribution cycles. - Lifecycle Management: Search local and remote repos, spin off incubated projects into their own repos, sync learnings via reunion, offload symlinks, and analyze git history. - Use Case: A user shares a GitHub URL they want to study. The Skill clones it with ghq, creates a symlink under ψ/learn/owner/repo, and later lets the user find, update, or offload it with simple slug-based commands. ## Quick Start Ask the assistant to learn from a GitHub repository by sharing its URL, for example: clone https://github.com/owner/repo so I can study it.

Frequently Asked Questions about project

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

FAQPage Schema
How do I clone a GitHub repo for study without duplicating files?▼

Use the learn action, which clones the repo once via ghq into a central directory and creates a symlink under ψ/learn/owner/repo. The ghq clone remains the single source of truth, so no files are ever copied.

How to contribute a quick fix to an external GitHub repository?▼

Use the incubate action with the --flash flag. It creates an issue, clones via ghq, creates a branch, and after you commit and push it opens a PR, then automatically removes the symlink and purges the clone.

What is the difference between ghq clone and symlink in this workflow?▼

ghq owns the actual clone in a central location like ~/Code/github.com/owner/repo, while ψ/learn and ψ/incubate contain only symlinks pointing to it. Offloading removes just the symlink, keeping the ghq clone for future use.

Does this require any specific tools to be installed?▼

Yes, the scripts require ghq for repository management, the GitHub CLI (gh) for repo creation and API access, and the Bun runtime to execute the TypeScript scripts. A ROOT environment variable must point to your workspace.

What happens if a symlink becomes broken?▼

Run a health check with find on the ψ/learn and ψ/incubate directories to detect broken symlinks. Restore the source by running ghq get -u with the repository URL, which re-clones or updates the ghq copy.

Is there a limit on how many projects I can incubate?▼

Yes, the incubate workspace is limited to 5 projects to reduce cognitive load and keep focus. The learn workspace has no limit since read-only references carry low overhead. Offload projects before incubating new ones.

Related Skills

Explore More Software Engineering Skills→
Soul-Brews-StudioSoul-Brews-Studio
116

project

Manage external GitHub repositories across local ghq clones and remote GitHub.

Official
Advanced
heman1033p-createheman1033p-create

project

Clone, track, and manage external GitHub repositories using ghq and symlinks.

Community
Advanced
GolferGeekGolferGeek

Orchestrator Git Standards

Enforce conventional branch names, commit messages, and repository organization for Git workflows.

Community
Basic
JEO-tech-aiJEO-tech-ai
8

git-submodule

Manage Git submodules for adding, updating, and removing external repositories.

Community
Advanced