What problem does it solve?
Projects shared as GitHub URLs are often cloned inconsistently, copied into multiple locations, or left unmanaged, making study and contribution workflows messy and hard to track. This Skill enforces a single source-of-truth cloning strategy using ghq plus organized psi symlinks so repositories are discoverable, reversible, and easy to offload.
Core Features & Use Cases
- Learn (read-only): Clone via ghq and create a psi/learn symlink for study and knowledge extraction.
- Incubate (active development): Clone or create repos, link into psi/incubate for focused work, and distribute hooks/settings.
- Search & Find: Local ghq-first search with GitHub API fallback to locate repositories or short slugs.
- Lifecycle operations: Offload symlinks, reunion (manifesting learnings), spinoff to a new GitHub repo, index manifests to Oracle, and generate git history reports.
- Use case: When a user says "I want to learn from https://github.com/owner/repo" this Skill clones the source, links it into your knowledge workspace, indexes docs, and records a reunion manifest.
Quick Start
Use the assistant command /project learn https://github.com/owner/repo to clone and link a repository into psi/learn for study.