project

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

116|56|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/Soul-Brews-Studio/oracle-skills-cli --skill project-soul-brews-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project
Source: https://github.com/Soul-Brews-Studio/oracle-skills-cli/tree/main/src/skills/project
Command: npx skills add https://github.com/Soul-Brews-Studio/oracle-skills-cli --skill project-soul-brews-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps software teams manage and reference external GitHub repositories for study and development workflows, reducing confusion about where a repo lives and how to access its resources.

Core Features & Use Cases

  • Learn (read-only study) clones and links repos for quick reference.
  • Incubate (active development) creates and tracks symlinked workspaces for ongoing contributions.
  • Search / Find / List across local ghq clones and GitHub to locate tracked projects quickly.

Quick Start

Instruct the agent to learn or incubate a repository, or to search for a project:

  • /project learn owner/repo
  • /project incubate owner/repo
  • /project search query

Frequently Asked Questions about project

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

FAQPage Schema
How do I track external GitHub repositories for study and development without losing track of local clones?

You can track external GitHub repositories for study and development by cloning them with ghq and creating symlinks under ψ directories with a slug registry, keeping local clones and remote projects organized for quick reference.

What is the best way to manage read-only study clones versus active development workspaces for GitHub repos?

Managing read-only study clones versus active development workspaces is handled by separating repos into 'learn' for read-only study references and 'incubate' for active development contributions using symlinked workspaces.

Do I need to install GitHub CLI and ghq before tracking external repositories?

Yes, you need GitHub CLI and ghq installed locally to track external repositories, because the system relies on bun, ghq, and GitHub CLI to search across local clones and remote GitHub for project management.

How do I search for a tracked project across local ghq clones and remote GitHub?

To search for a tracked project across local ghq clones and remote GitHub, instruct the agent with a search query and it will locate the repository using the slug registry across both local and remote environments.

How do I clone and link a GitHub repository for quick read-only reference?

To clone and link a GitHub repository for quick read-only reference, use the 'learn' command to clone the repo via ghq and generate symlinks under ψ directories, adding it to the slug registry for study access.