project
/project
Klonuje i śledzi zewnętrzne repozytoria, gdy użytkownik podaje adres GitHub do przestudiowania lub dalszego rozwijania albo pyta, gdzie znajduje się dany projekt.
- Autor
- Soul-Brews-Studio ↗
- Repozytorium
- arra-oracle-skills-cli ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 03.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 14
- Skrypty
- 11
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 6
Brak sygnałów. Repozytorium zmienione 03.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 11 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/create.ts, scripts/history.ts, scripts/incubate.ts, scripts/index.ts, scripts/learn.ts, scripts/offload.ts, scripts/resolve-slug.ts, scripts/reunion.ts, scripts/search.ts, scripts/spinoff.ts, scripts/utils.ts
Co robi i kiedy
Klonuje i śledzi zewnętrzne repozytoria, gdy użytkownik podaje adres GitHub do przestudiowania lub dalszego rozwijania albo pyta, gdzie znajduje się dany projekt.
Wyzwalacze z opisu
Argumenty
/project <github-url> | search <query>
Oryginalny opis (EN)
Clone and track external repos. Use when user shares a GitHub URL to study or develop, or says "search repos", "find repo", "where is [project]". For active development, use /incubate.
Jak działa
- Golden Rule
- When to Use
- Step 0 — Anchor (date-stamp + root)
- Actions
- Directory Structure
- Health Check
- Examples
- Anti-Patterns
- Quick Reference
Podgląd SKILL.md
---
name: project
description: Clone and track external repos. Use when user shares a GitHub URL to study or develop, or says "search repos", "find repo", "where is [project]". For active development, use /incubate.
argument-hint: "<github-url> | search <query>"
---
# project-manager
Track and manage external repos: Learn (study) | Incubate (develop)
## Golden Rule
**ghq owns the clone → ψ/ owns the symlink**
Never copy. Always symlink. One source of truth.
## When to Use
Invoke this skill when:
- User shares a GitHub URL and wants to study/clone it
- User mentions wanting to learn from a codebase
- User wants to start developing on an external repo
- Need to find where a previously cloned project lives
## Step 0 — Anchor (date-stamp + root)
```bash
date "+🕐 %H:%M %Z (%A %d %B %Y)"
# Find oracle root — git toplevel that has CLAUDE.md + ψ/
ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -n "$ORACLE_ROOT" ] && [ -f "$ORACLE_ROOT/CLAUDE.md" ] && { [ -d "$ORACLE_ROOT/ψ" ] || [ -L "$ORACLE_ROOT/ψ" ]; }; then
PSI="$ORACLE_ROOT/ψ"
elif [ -f "$(pwd)/CLAUDE.md" ] && { [ -d "$(pwd)/ψ" ] || [ -L "$(pwd)/ψ" ]; }; then
ORACLE_ROOT="$(pwd)"
PSI="$ORACLE_ROOT/ψ"
else
echo "⚠️ Not in oracle repo (no CLAUDE.md + ψ/ at git root). Writing to pwd."
ORACLE_ROOT="$(pwd)"
PSI="$ORACLE_ROOT/ψ"
fi
```
## Actions
### learn [url|slug]
Clone repo for **study** (read-only reference).
```bash
# 1. Clone via ghq
ghq get -u https://github.com/owner/repo
# 2. Create org/repo symlink structure
GHQ_ROOT=$(ghq root)
mkdir -p "$PSI/learn/owner"
ln -sf "$GHQ_ROOT/github.com/owner/repo" "$PSI/learn/owner/repo"
```
**Output** (announce-mode — absolute path):
# announce-mode → absolute path (no ψ/, no ~/, no $VAR, no ...).
# Use: echo "marker: $RESOLVED_PATH" — bash substitutes. See CONVENTIONS.md.
```bash
LINK="$PSI/learn/owner/repo"
echo "✅ Linked: $LINK"
```
### incubate — REDIRECTS TO /incubate
> **`/project incubate` is now `/incubate`.**
> If the user says `/project incubate [args]`, run `/incubate [args]` instead.
> Do NOT execute incubate logic here — invoke the standalone `/incubate` skill with the same arguments.
### find [query]
Search for project across all locations:
```bash
# Search ghq repos
ghq list | grep -i "query"
# Search learn/incubate symlinks (org/repo structure)
find "$PSI/learn" "$PSI/incubate" -type l 2>/dev/null | grep -i "query"
```
**Output**: List matches with their ghq paths
### list
Show all tracked projects with rich metadata (#227):
```bash
echo "📦 Projects"
echo ""
# Collect all tracked repos (learn + incubate symlinks)
REPOS=()
for link in $(find "$PSI/learn" "$PSI/incubate" -name "origin" -type l 2>/dev/null | sort); do
dir=$(dirname "$link")
owner=$(basename "$(dirname "$dir")")
repo=$(basename "$dir")
type="learn"
echo "$link" | grep -q "incubate" && type="incubate"
REPOS+=("$owner/$repo:$type")
done
if [ ${#REPOS[@]} -eq 0 ]; then
echo " No tracked projects. Use /learn or /incubate to add."
else
printf " %-35s %-6s %-8s %-8s %s\n" "Repo" "Stars" "License" "Type" "Description"
printf " %-35s %-6s %-8s %-8s %s\n" "───────────────────────────────────" "──────" "────────" "────────" "──────────────────────"
for entry in "${REPOS[@]}"; do
slug="${entry%%:*}"
type="${entry##*:}"
# Fetch metadata from GitHub (cached per session)
meta=$(gh api "repos/$slug" --jq '"\(.stargazers_count)\t\(.license.spdx_id // "none")\t\(.description // "-" | .[0:40])"' 2>/dev/null || echo "?\tnone\t-")
stars=$(echo "$meta" | cut -f1)
license=$(echo "$meta" | cut -f2)
desc=$(echo "$meta" | cut -f3)
printf " %-35s %-6s %-8s %-8s %s\n" "$slug" "⭐$stars" "$license" "$type" "$desc"
done
fi
echo ""
echo " Total: ${#REPOS[@]} tracked repos"
```
## Directory Structure
```
ψ/
├── learn/owner/repo → ~/Code/github.com/owner/repo (symlink)
└── incubate/owner/repo → ~/Code/github.com/owner/repo (symlink)
~/Code/ ← ghq root (source of truth)
└── github.com/owner/repo/ (actual clone)
```
## Health Check
When listing, verify symlinks are valid:
```bash
# Check for broken symlinks
find "$PSI/learn" "$PSI/incubate" -type l ! -exec test -e {} \; -print 2>/dev/null
```
If broken: `ghq get -u [url]` to restore source.
## Examples
```
# User shares URL to study
User: "I want to learn from https://github.com/SawyerHood/dev-browser"
→ ghq get -u https://github.com/SawyerHood/dev-browser
→ mkdir -p ψ/learn/SawyerHood
→ ln -sf ~/Code/github.com/SawyerHood/dev-browser ψ/learn/SawyerHood/dev-browser
# User wants to develop → redirect to /incubate
User: "I want to work on claude-mem"
→ /incubate https://github.com/thedotmack/claude-mem
# User says "/project incubate" → redirect to /incubate
User: "/project incubate https://github.com/Soul-Brews-Studio/arra-oracle-v3 --contribute"
→ /incubate https://github.com/Soul-Brews-Studio/arra-oracle-v3 --contribute
```
## Anti-Patterns
| ❌ Wrong | ✅ Right |
|----------|----------|
| `git clone` directly to ψ/ | `ghq get` then symlink |
| Flat: `ψ/learn/repo-name` | Org structure: `ψ/learn/owner/repo` |
| Copy files | Symlink always |
| Manual clone outside ghq | Everything through ghq |
## Quick Reference
```bash
# Add to learn
ghq get -u URL && mkdir -p "$PSI/learn/owner" && ln -sf "$(ghq root)/github.com/owner/repo" "$PSI/learn/owner/repo"
# Incubate (use standalone /incubate skill)
/incubate URL [--flash | --contribute | --status | --offload]
# Update source
ghq get -u URL
# Find repo
ghq list | grep name
```
Pliki w paczce (14)
- SKILL.md 6 KB
- project-manager.md 5 KB
- scripts/create.ts 2 KB
- scripts/history.ts 2 KB
- scripts/incubate.ts 2 KB
- scripts/index.ts 3 KB
- scripts/learn.ts 2 KB
- scripts/offload.ts 1 KB
- scripts/resolve-slug.ts 1 KB
- scripts/reunion.ts 3 KB
- scripts/search.ts 2 KB
- scripts/spinoff.ts 2 KB
- scripts/utils.ts 4 KB
- templates/slugs.yaml 1 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · Soul-Brews-Studio/arra-oracle-skills-cli | 100 | MIT |
| LandonSchropp/agent-toolkit | 100 | MIT |
| stefanocaronia/claude-project | 100 | MIT |
| erayozenn/BigHead-2ndBrain | 100 | MIT |
| adivmaimon/Caddis | 100 | MIT |
| samchon/typia | 100 | MIT |
| systemfsoftware/systemfsoftware | 100 | Apache-2.0 |
| systemfsoftware/systemfsoftware | 100 | Apache-2.0 |
| kriegcloud/beep-beginners | 100 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki c778da4d9fb5 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 91incubate
Klonuje lub zakłada repozytorium do aktywnego rozwoju, także z osobnym worktree dla każdego agenta pracującego równolegle. - 100learn
Bada bazę kodu równoległymi agentami Haiku: klonuje repozytorium, czyta je i dokumentuje, w trybie szybkim z jednym agentem, domyślnym z trzema lub głębokim z pięcioma. - 95clone-repos
Klonuje hurtowo zestaw repozytoriów git do jednego katalogu skryptem clone-repos.sh, jako pierwszy krok przed przeglądem architektury. - 100my-repos
Lokalizuje repozytoria dwmkerra i pomaga z nimi pracować, gdy użytkownik wspomina o moich repozytoriach lub potrzebuje znaleźć konkretne repozytorium. - 100github
Klonuje i wypycha repozytoria GitHub przez git i obsługuje issues, pull requests oraz pliki przez API, dla dowolnego zadania. - 100ghsync
Klonuje hurtowo i synchronizuje wszystkie repozytoria GitHub dostępne w organizacji lub koncie osobistym, usuwa duplikaty, klonuje nowe i aktualizuje istniejące repozytoria razem z ich worktree.