# Github Import

> Импорт файлов GitHub-репо как контекст: токены, компоненты, стили. Триггеры: «сделай в стиле этого репо», «из репо токены», «воссоздай UI».

- Skill: `jhamidun/github-import-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jhamidun/github-import-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jhamidun/github-import-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: JHamidun (https://skillmd.com/u/jhamidun)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jhamidun/github-import-2

---


# GitHub import

Без авторизации можно тянуть публичные репы через raw.githubusercontent.com и API. Для приватных нужен токен.

## Парсинг URL

```
https://github.com/OWNER/REPO                          → весь реп, default branch
https://github.com/OWNER/REPO/tree/REF/PATH            → папка
https://github.com/OWNER/REPO/blob/REF/PATH/file.ext   → один файл
```

```js
function parseGithubUrl(url) {
  const u = new URL(url);
  const [, owner, repo, type, ref, ...path] = u.pathname.split('/');
  return { owner, repo, type, ref: ref || 'HEAD', path: path.join('/') };
}
```

## Получение

**Один файл (raw):**
```
https://raw.githubusercontent.com/OWNER/REPO/REF/PATH
```

**Список папки (API):**
```
https://api.github.com/repos/OWNER/REPO/contents/PATH?ref=REF
```

**Дерево целиком (API, может быть большим):**
```
https://api.github.com/repos/OWNER/REPO/git/trees/REF?recursive=1
```

Без токена rate-limit 60 запросов/час с IP. С токеном — 5000. Токен передаётся как `Authorization: Bearer ghp_...`.

## Стратегия импорта

Дерево — это меню, не еда. Не клади себе в контекст рекурсивный листинг на 5000 файлов. Вместо этого:

1. **Не-рекурсивный листинг корня.** Понять, какой это стек (есть ли `package.json`, `tailwind.config`, `theme.ts`, `_variables.scss`).
2. **Прицельные файлы.** Скачивай только то, что точно нужно:
   - **Тема/токены:** `theme.ts`, `colors.ts`, `tokens.css`, `_variables.scss`, `tailwind.config.{js,ts}`, `globals.css`.
   - **Конкретные компоненты, упомянутые пользователем.**
   - **Глобальные стили.**
3. **Прочитай эти файлы.** Не строй UI по «памяти, как этот сайт примерно выглядит» — это даёт generic look-alike. Бери hex-коды, шрифты, скейлы отступов, радиусы прямо оттуда.

## Скрипт

`templates/gh-pull.sh` — bash-скрипт-обёртка:

```bash
templates/gh-pull.sh https://github.com/owner/repo/tree/main/src/theme
# → выкачает все файлы из этой папки в ./gh-import/owner-repo/src/theme/
```

Использует только `curl` и `jq`.

## После импорта

В корне импорта оставь `_INDEX.md` с:
- Что это за реп.
- Какие файлы импортированы и зачем.
- Какие ключевые значения (палитра, шрифт, радиусы) уже извлечены.

Потом на это ссылайся при дизайне: «использую палитру из gh-import/owner-repo/src/theme/colors.ts».

## Важно

Не воспроизводи защищённые товарным знаком интерфейсы 1:1, даже если код открыт. Бери токены и принципы, но делай **оригинальный** дизайн. Особенно если репо принадлежит крупному продукту (мессенджеры, соцсети, известные SaaS) — повторение их UI попадает под претензии по интеллектуальной собственности.

## Legacy reference

Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в `references/legacy-github-import.md`. Секции там: Использование, Что искать в существующем проекте, Output: project-context.md, Stack, Tokens (use these names), Components (use these instead of building new), Conventions, Routes, Что НЕ копировать, Multi-repo контекст, Антипаттерны.