cli-surf 0.11.0

package/cliUi.js

@@ -0,0 +1,436 @@
+/**
+ * Терминальный UI для Surf CLI — в духе Claude Code / Codex, в цветах мессенджера.
+ * Без внешних зависимостей: только ANSI + stdout. Цвета гаснут при NO_COLOR,
+ * pipe или не-TTY, чтобы вывод оставался пригодным для скриптов.
+ */
+import { emitKeypressEvents } from 'node:readline';
+let cliLanguage = 'ru';
+export function setCliLanguage(value) {
+    cliLanguage = value === 'en' || value === 'English' ? 'en' : 'ru';
+}
+export function isRussian() {
+    return cliLanguage === 'ru';
+}
+/** Short UI string with the account language selected in the messenger. */
+export function tr(ru, en) {
+    return isRussian() ? ru : en;
+}
+export const OPUS_MODEL_IDS = [
+    'auto', 'fast', 'advanced', 'sol', 'terra', 'luna',
+    'gpt54mini', 'gpt54nano', 'gpt5mini', 'gpt5nano',
+    'o3', 'o3mini', 'o4mini',
+    'gemini37flash', 'gemini35flashlite', 'gemini31pro', 'gemini25pro',
+    'musespark13', 'musespark12',
+    'grok46',
+];
+/** Человеческие имена — один в один как в мессенджере (OPUS_MODELS). */
+const MODEL_DISPLAY = {
+    auto: 'Auto',
+    fast: 'GPT-4o mini',
+    advanced: 'GPT-4o',
+    sol: 'GPT-5.6 Sol',
+    terra: 'GPT-5.6 Terra',
+    luna: 'GPT-5.6 Luna',
+    gpt54mini: 'GPT-5.4 Mini',
+    gpt54nano: 'GPT-5.4 Nano',
+    gpt5mini: 'GPT-5 Mini',
+    gpt5nano: 'GPT-5 Nano',
+    o3: 'o3',
+    o3mini: 'o3-mini',
+    o4mini: 'o4-mini',
+    gemini37flash: 'Gemini 3.7 Flash',
+    gemini35flashlite: 'Gemini 3.5 Flash-Lite',
+    gemini31pro: 'Gemini 3.1 Pro',
+    gemini25pro: 'Gemini 2.5 Pro',
+    musespark13: 'Muse Spark 1.3',
+    musespark12: 'Muse Spark 1.2',
+    grok46: 'Grok 4.6',
+};
+export function modelDisplayName(id) {
+    return MODEL_DISPLAY[id] ?? id;
+}
+/** Вручную выбираются настоящие модели. Скрыты только режимы:
+ * auto (дефолт), fast (дешёвая для free), advanced (legacy GPT-4o).
+ * Скрытые работают, если задать явно: /model fast, --model auto. */
+const HIDDEN_ALIASES = new Set(['auto', 'fast', 'advanced']);
+export const PICKABLE_MODEL_IDS = OPUS_MODEL_IDS.filter(id => !HIDDEN_ALIASES.has(id));
+/** «GPT-5 Mini» → «gpt5mini»: регистр, пробелы, точки и дефисы не важны. */
+export function normModelKey(raw) {
+    return raw.toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+const ANSI = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    italic: '\x1b[3m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+    peach: '\x1b[38;5;216m',
+    blue: '\x1b[38;5;75m',
+    green: '\x1b[38;5;42m',
+    red: '\x1b[38;5;203m',
+    yellow: '\x1b[38;5;221m',
+    codeBg: '\x1b[48;5;238m',
+};
+/** Персональный акцент как в мессенджере (settings.accentColor).
+ * Дефолт мессенджера — синий #3287FE; персиковый — только до входа. */
+const ACCENT_FALLBACK = ANSI.peach;
+const MESSENGER_DEFAULT_ACCENT = '#3287FE';
+let accentRgb = null;
+export function defaultAccentHex() {
+    return MESSENGER_DEFAULT_ACCENT;
+}
+/** Задать акцент (#RGB или #RRGGBB). null/мусор — сброс к фолбэку. */
+export function setAccentColor(hex) {
+    const m = typeof hex === 'string' ? hex.trim().match(/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i) : null;
+    if (!m) {
+        accentRgb = null;
+        return;
+    }
+    let h = m[1];
+    if (h.length === 3)
+        h = h.split('').map(c => c + c).join('');
+    accentRgb = [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+function accentEscape() {
+    if (!accentRgb)
+        return ACCENT_FALLBACK;
+    return `\x1b[38;2;${accentRgb[0]};${accentRgb[1]};${accentRgb[2]}m`;
+}
+export function uiEnabled(stream = process.stdout) {
+    if (process.env.NO_COLOR !== undefined)
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return !!stream.isTTY;
+}
+let colorsOn = uiEnabled();
+/** Форсированно выключить цвета (например, для --json). */
+export function setUiColors(on) {
+    colorsOn = on && uiEnabled();
+}
+export function paint(text, ...styles) {
+    if (!colorsOn || styles.length === 0)
+        return text;
+    const seq = styles.map(s => (s === 'accent' ? accentEscape() : ANSI[s])).join('');
+    return `${seq}${text}${ANSI.reset}`;
+}
+export function stripLine(text) {
+    const ESC = String.fromCharCode(0x1b);
+    let out = '';
+    let i = 0;
+    for (;;) {
+        const j = text.indexOf(ESC, i);
+        if (j < 0) {
+            out += text.slice(i);
+            break;
+        }
+        out += text.slice(i, j);
+        const m = /^\[[0-9;]*m/.exec(text.slice(j + 1));
+        i = m ? j + 1 + m[0].length : j + 1;
+    }
+    return out;
+}
+/** Подпись статуса стрима — те же смыслы, что в мессенджере. */
+export function statusLabel(status) {
+    switch (status) {
+        case 'search': return tr('Ищу в вебе…', 'Searching the web…');
+        case 'chats': return tr('Читаю переписки…', 'Reading chats…');
+        case 'images': return tr('Подбираю фото…', 'Finding images…');
+        case 'map': return tr('Строю карту…', 'Building a map…');
+        case 'file': return tr('Собираю файл…', 'Creating a file…');
+        case 'github': return tr('Работаю с GitHub…', 'Working with GitHub…');
+        case 'gitlab': return tr('Работаю с GitLab…', 'Working with GitLab…');
+        case 'notion': return tr('Работаю с Notion…', 'Working with Notion…');
+        case 'google-calendar': return tr('Работаю с Google Calendar…', 'Working with Google Calendar…');
+        case '101': return tr('Работаю с 101…', 'Working with 101…');
+        case 'calling': return tr('Звоню…', 'Calling…');
+        default: return tr('Думаю…', 'Thinking…');
+    }
+}
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/** Спиннер в stderr — stdout остаётся чистым для pipe. */
+export class Spinner {
+    timer = null;
+    frame = 0;
+    label = '';
+    active = false;
+    start(label) {
+        this.label = label;
+        if (!colorsOn || !process.stderr.isTTY)
+            return;
+        if (this.active)
+            return;
+        this.active = true;
+        this.timer = setInterval(() => {
+            const glyph = paint(SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length], 'accent');
+            process.stderr.write(`\r\x1b[K${glyph} ${paint(this.label, 'gray')}`);
+            this.frame += 1;
+        }, 80);
+    }
+    update(label) {
+        this.label = label;
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        if (this.active)
+            process.stderr.write('\r\x1b[K');
+        this.active = false;
+    }
+}
+function renderInline(text) {
+    if (!colorsOn)
+        return text;
+    // Сначала прячем код, чтобы ** внутри кода не красились.
+    // Маркер из Private Use Area — не встречается в обычных ответах.
+    const MARK = '';
+    const codeSpans = [];
+    const hidden = text.replace(/`([^`\n]+)`/g, (_, code) => {
+        codeSpans.push(code);
+        return `${MARK}${codeSpans.length - 1}${MARK}`;
+    });
+    const styled = hidden
+        .replace(/\*\*([^*]+)\*\*/g, (_, b) => `${ANSI.bold}${b}${ANSI.reset}`)
+        .replace(/(^|[\s(])\*([^*\n]+)\*/g, (_, pre, it) => `${pre}${ANSI.italic}${it}${ANSI.reset}`);
+    const markRe = new RegExp(`${MARK}(\\d+)${MARK}`, 'g');
+    return styled.replace(markRe, (_, i) => {
+        const code = codeSpans[Number(i)] ?? '';
+        return `${ANSI.codeBg}${ANSI.white} ${code} ${ANSI.reset}`;
+    });
+}
+function renderLine(line, inFence) {
+    if (/^\s*```/.test(line)) {
+        return paint(line.trim() ? '```' + line.trim().slice(3) : '```', 'gray');
+    }
+    if (inFence)
+        return paint(line || ' ', 'gray');
+    const header = line.match(/^(#{1,4})\s+(.*)$/);
+    if (header)
+        return `${paint(header[2], 'bold', 'white')}`;
+    const quote = line.match(/^>\s?(.*)$/);
+    if (quote)
+        return `${paint('▏', 'accent')} ${paint(quote[1], 'gray')}`;
+    const list = line.match(/^(\s*)([-*]|\d+[.)])\s+(.*)$/);
+    if (list)
+        return `${list[1]}${paint('•', 'accent')} ${renderInline(list[3])}`;
+    if (/^\s*([-*_])(\s*\1){2,}\s*$/.test(line))
+        return paint('─'.repeat(24), 'gray');
+    if (/^\s*\|.*\|\s*$/.test(line))
+        return paint(line, 'gray');
+    return renderInline(line);
+}
+/**
+ * Построчный markdown-рендер для стрима: копим неполную строку,
+ * готовые строки отдаём уже раскрашенными. Состояние ``` тянется между строк.
+ */
+export class MdStream {
+    buf = '';
+    inFence = false;
+    push(chunk) {
+        this.buf += chunk;
+        const parts = this.buf.split('\n');
+        this.buf = parts.pop() ?? '';
+        let out = '';
+        for (const line of parts) {
+            out += this.render(line) + '\n';
+        }
+        return out;
+    }
+    flush() {
+        if (!this.buf)
+            return '';
+        const out = this.render(this.buf);
+        this.buf = '';
+        return out;
+    }
+    render(line) {
+        const rendered = renderLine(line, this.inFence);
+        if (/^\s*```/.test(line))
+            this.inFence = !this.inFence;
+        return rendered;
+    }
+}
+/** Полоса лимита как в OpusUsageCard: синяя used-часть, dim-остаток. */
+export function progressBar(percentUsed, width = 24) {
+    const clamped = Math.max(0, Math.min(100, percentUsed));
+    const filled = Math.round((clamped / 100) * width);
+    const bar = '█'.repeat(filled) + '░'.repeat(width - filled);
+    if (!colorsOn)
+        return `[${bar}]`;
+    return `[${paint('█'.repeat(filled), 'blue')}${paint('░'.repeat(width - filled), 'gray')}]`;
+}
+function formatReset(resetsAt) {
+    const d = new Date(resetsAt);
+    if (Number.isNaN(d.getTime()))
+        return resetsAt;
+    return d.toLocaleDateString(isRussian() ? 'ru-RU' : 'en-US', { day: 'numeric', month: 'long' });
+}
+/** Карточка лимита — терминальная версия OpusUsageCard. */
+export function usageCard(u) {
+    const head = `${paint(tr('Использовано', 'Used'), 'gray')}  ${paint(`${u.usedCredits} / ${u.limitCredits}`, 'bold', 'white')} ${paint(tr('кредитов', 'credits'), 'gray')}`;
+    const bar = `  ${progressBar(u.percentUsed)} ${paint(`${u.percentUsed}%`, 'bold', 'white')}`;
+    const legend = `  ${paint('●', 'blue')} ${paint(tr(`осталось ${u.remainingCredits}`, `${u.remainingCredits} remaining`), 'white')}   ${paint('○', 'gray')} ${paint(tr(`сброс ${formatReset(u.resetsAt)}`, `resets ${formatReset(u.resetsAt)}`), 'gray')}`;
+    const lines = ['', head, bar, legend];
+    if (u.creditBalance > 0) {
+        lines.push(`  ${paint(tr('Доп. баланс:', 'Extra balance:'), 'gray')} ${paint(String(u.creditBalance), 'white')}`);
+    }
+    if (u.cheapModeOnly) {
+        lines.push(`  ${paint(tr('⚠ cheap-mode: лимит исчерпан, отвечает только дешёвая модель', '⚠ cheap mode: the limit is exhausted; only the economy model is available'), 'yellow')}`);
+    }
+    return lines.join('\n');
+}
+/** Шапка чата: бренд + модель + остаток. */
+export function chatBanner(opts) {
+    const title = `${paint('◆', 'accent')} ${paint('Surf', 'bold', 'white')} ${paint(`v${opts.version}`, 'gray')}`;
+    const modelLine = `  ${paint(tr('модель', 'model'), 'gray')} ${paint(opts.model, 'white')}`;
+    const info = opts.usage
+        ? `  ${paint(tr('лимит', 'limit'), 'gray')} ${paint(`${opts.usage.remainingCredits}/${opts.usage.limitCredits}`, opts.usage.remainingCredits <= 0 ? 'red' : 'white')} ${paint(`· ${opts.usage.plan}`, 'gray')}`
+        : '';
+    const hint = `  ${paint(tr('/help — команды · Ctrl+C — выход', '/help — commands · Ctrl+C — exit'), 'gray')}`;
+    return ['', title, modelLine, info, hint, ''].filter(l => l !== '').join('\n');
+}
+/** Строка после ответа: модель + остаток. */
+export function answerFooter(model, usage) {
+    if (!usage)
+        return '';
+    return paint(tr(`— ${model} · осталось ${usage.remainingCredits}/${usage.limitCredits} · ${usage.plan}`, `— ${model} · ${usage.remainingCredits}/${usage.limitCredits} remaining · ${usage.plan}`), 'gray');
+}
+/** Заголовок ответа ассистента. */
+export function assistantHead(model) {
+    return `${paint('◆', 'accent')} ${paint('Opus', 'bold', 'accent')} ${paint(`· ${model}`, 'gray')}`;
+}
+/** Автокомплит для readline: /команды и id моделей после /model. */
+export function completer(line) {
+    const commands = ['/usage', '/model', '/permissions', '/clear', '/help', '/skills', '/logout', '/exit', '/quit'];
+    if (line.startsWith('/model ')) {
+        const frag = line.slice('/model '.length);
+        return [PICKABLE_MODEL_IDS.filter(m => m.startsWith(frag)).map(m => `/model ${m}`), line];
+    }
+    if (line.startsWith('/')) {
+        return [commands.filter(c => c.startsWith(line)), line];
+    }
+    return [[], line];
+}
+/** Пронумерованный список — fallback без TTY. Читает через очередь чата. */
+export async function selectNumbered(title, options, readLine) {
+    if (options.length === 0)
+        return null;
+    console.log(paint(title, 'gray'));
+    options.forEach((o, i) => {
+        const num = paint(String(i + 1), 'white');
+        const name = paint(o.label ?? o.id, 'bold', 'white');
+        const hint = o.hint ? paint(` → ${o.hint}`, 'gray') : '';
+        const cur = o.current ? paint(tr(' (текущая)', ' (current)'), 'accent') : '';
+        console.log(`  ${num} ${name}${hint}${cur}`);
+    });
+    process.stdout.write(paint(tr('Номер (Enter — отмена): ', 'Number (Enter — cancel): '), 'accent'));
+    const answer = ((await readLine()) ?? '').trim();
+    if (!answer)
+        return null;
+    const n = Number(answer);
+    if (!Number.isInteger(n) || n < 1 || n > options.length)
+        return null;
+    return n - 1;
+}
+/** Можно ли показать стрелочный пикер (нужен живой TTY). */
+export function canUseArrows() {
+    return !!process.stdin.isTTY && !!process.stdout.isTTY && colorsOn;
+}
+/** Подсказка по командам чата. */
+export function chatHelp() {
+    const rows = [
+        ['/usage', tr('общий лимит с мессенджером', 'shared messenger limit')],
+        ['/model [name]', tr('выбор стрелками, запоминается', 'choose with arrows; saved')],
+        ['/permissions', tr('режим подтверждений агента', 'agent confirmation mode')],
+        ['! text', tr('выполнить как задачу с файлами', 'run as a task with files')],
+        ['/clear', tr('очистить историю чата', 'clear chat history')],
+        ['/logout', tr('выйти из аккаунта', 'sign out')],
+        ['/skills', tr('навыки агента', 'agent skills')],
+        ['/[skill-name]', tr('вызвать навык', 'run a skill')],
+        ['/exit', tr('выйти', 'exit')],
+    ];
+    return rows.map(([cmd, desc]) => `  ${paint(cmd, 'accent')}  ${paint(desc, 'gray')}`).join('\n');
+}
+let keypressHooked = false;
+/**
+ * Удобный выбор из списка как в Claude Code: ↑↓ (или j/k), Enter — выбор,
+ * Esc — отмена. Возвращает индекс или null (отмена).
+ * Требование: в момент вызова НЕТ активного readline-интерфейса на stdin
+ * (чат его закрывает и пересоздаёт после пикера).
+ */
+export async function selectArrows(title, options, footer) {
+    if (options.length === 0)
+        return null;
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const emitter = stdin;
+    let selected = Math.max(0, options.findIndex(o => o.current));
+    const total = 1 + options.length + (footer ? 1 : 0);
+    const render = () => {
+        const lines = [paint(title, 'gray')];
+        options.forEach((o, i) => {
+            const active = i === selected;
+            const cursor = active ? paint('❯', 'accent') : ' ';
+            const label = o.label ?? o.id;
+            const name = active ? paint(label, 'bold', 'white') : paint(label, 'gray');
+            const hint = o.hint ? paint(` → ${o.hint}`, 'gray') : '';
+            const cur = o.current ? paint(' (текущая)', 'accent') : '';
+            lines.push(`${cursor} ${name}${hint}${cur}`);
+        });
+        if (footer)
+            lines.push(paint(footer, 'gray'));
+        stdout.write(`${lines.map(l => `\x1b[K${l}`).join('\n')}\n`);
+    };
+    render();
+    return new Promise(resolve => {
+        const done = (value) => {
+            emitter.removeListener('keypress', onKey);
+            try {
+                stdin.setRawMode(false);
+            }
+            catch { /* уже не raw */ }
+            stdin.pause();
+            stdout.write('\x1b[?25h');
+            // Стереть меню без разрыва в истории: вверх на высоту блока
+            // и очистить всё ниже курсора (блок — последние строки экрана).
+            stdout.write(`\x1b[${total}A`);
+            stdout.write('\x1b[J');
+            resolve(value);
+        };
+        const redraw = () => {
+            stdout.write(`\x1b[${total}A`);
+            render();
+        };
+        const onKey = (_str, key) => {
+            const name = key?.name ?? '';
+            if (name === 'up' || name === 'k') {
+                selected = (selected - 1 + options.length) % options.length;
+                redraw();
+                return;
+            }
+            if (name === 'down' || name === 'j') {
+                selected = (selected + 1) % options.length;
+                redraw();
+                return;
+            }
+            if (name === 'return') {
+                done(selected);
+                return;
+            }
+            if (name === 'escape' || name === 'q' || (name === 'c' && key?.ctrl)) {
+                done(null);
+            }
+        };
+        if (!keypressHooked) {
+            emitKeypressEvents(stdin);
+            keypressHooked = true;
+        }
+        emitter.on('keypress', onKey);
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdout.write('\x1b[?25l');
+    });
+}
+//# sourceMappingURL=cliUi.js.map

package/opusModels.js

@@ -0,0 +1,83 @@
+export function normalizeOpusModelId(value) {
+    if (value === 'auto'
+        || value === 'sol'
+        || value === 'terra'
+        || value === 'luna'
+        || value === 'gpt54mini'
+        || value === 'gpt54nano'
+        || value === 'gpt5mini'
+        || value === 'gpt5nano'
+        || value === 'o3'
+        || value === 'o3mini'
+        || value === 'o4mini'
+        || value === 'gemini37flash'
+        || value === 'gemini35flashlite'
+        || value === 'gemini31pro'
+        || value === 'gemini25pro'
+        || value === 'musespark13'
+        || value === 'musespark12'
+        || value === 'grok46')
+        return value;
+    if (value === 'fast' || value === 'advanced')
+        return value;
+    return 'auto';
+}
+export function opusProviderModel(model) {
+    if (model === 'auto')
+        return 'openai/gpt-5.6-terra';
+    if (model === 'sol')
+        return 'openai/gpt-5.6-sol';
+    if (model === 'terra')
+        return 'openai/gpt-5.6-terra';
+    if (model === 'luna')
+        return 'openai/gpt-5.6-luna';
+    if (model === 'gpt54mini')
+        return 'openai/gpt-5.4-mini';
+    if (model === 'gpt54nano')
+        return 'openai/gpt-5.4-nano';
+    if (model === 'gpt5mini')
+        return 'openai/gpt-5-mini';
+    if (model === 'gpt5nano')
+        return 'openai/gpt-5-nano';
+    if (model === 'o3')
+        return 'openai/o3';
+    if (model === 'o3mini')
+        return 'openai/o3-mini';
+    if (model === 'o4mini')
+        return 'openai/o4-mini';
+    if (model === 'gemini37flash')
+        return 'gemini/gemini-3.7-flash';
+    if (model === 'gemini35flashlite')
+        return 'gemini/gemini-3.5-flash-lite';
+    if (model === 'gemini31pro')
+        return 'gemini/gemini-3.1-pro-preview';
+    if (model === 'gemini25pro')
+        return 'gemini/gemini-2.5-pro';
+    if (model === 'musespark13')
+        return 'meta/muse-spark-1.3-contributor';
+    if (model === 'musespark12')
+        return 'meta/muse-spark-1.2-contributor';
+    if (model === 'grok46')
+        return 'x-ai/grok-4.6';
+    return model === 'advanced' ? 'openai/gpt-4o' : 'openai/gpt-4o-mini';
+}
+export function isReasoningProviderModel(model) {
+    return typeof model === 'string' && model.startsWith('openai/o');
+}
+export function normalizeReasoningEffort(value) {
+    if (value === 'low' || value === 'high')
+        return value;
+    return 'medium';
+}
+export function autoOpusModelForRequest(text, history, attachments) {
+    const prompt = typeof text === 'string' ? text.trim() : '';
+    const historyLength = Array.isArray(history) ? history.length : 0;
+    const attachmentCount = Array.isArray(attachments) ? attachments.length : 0;
+    const complexRequest = /(?:анализ|проанализ|исслед|сравни|документ|архитектур|код|программ|план|стратег|математ|доказ|analy[sz]|research|compare|document|architect|\bcode\b|program|strategy|math|prove)/i.test(prompt);
+    if (attachmentCount > 0 || prompt.length > 1000 || historyLength >= 8 || complexRequest)
+        return 'sol';
+    if (prompt.length < 180 && historyLength <= 2)
+        return 'luna';
+    return 'terra';
+}
+//# sourceMappingURL=opusModels.js.map

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "cli-surf",
+  "version": "0.11.0",
+  "description": "Surf Opus CLI — terminal client for Surf messenger with shared AI limits",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "surf": "cli.js",
+    "opus": "cli.js"
+  },
+  "files": [
+    "cli.js",
+    "cliUi.js",
+    "cliPrompt.js",
+    "cliTools.js",
+    "cliSkills.js",
+    "opusModels.js",
+    "skills/**/*",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "surf",
+    "opus",
+    "cli",
+    "ai",
+    "chat"
+  ]
+}

package/skills/commit/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: commit
+description: Git-коммит по conventional commits — смотрит diff, пишет сообщение, коммитит. Пуш только если просят.
+version: "1.0"
+---
+
+# Git commit
+
+Сделай коммит текущих изменений по conventional commits.
+
+## Как работать
+
+1. `git status` и `git diff` — пойми, что меняется. `git log --oneline -5` — подхвати стиль сообщений репозитория.
+2. Проверь, что не коммитишь мусор: секреты (.env, ключи), временные файлы, артефакты сборки, свои отладочные скрипты. Такое не добавлять, предупредить пользователя.
+3. Собери сообщение: `<type>: <кратко>`, типы — feat, fix, chore, refactor, docs, test. Тело — только если изменение неочевидное.
+4. Закоммить: `git add` только нужные файлы (не `git add -A` вслепую), затем `git commit -m`.
+5. НЕ пушить без прямой просьбы. НЕ менять конфиг git, НЕ форсить, НЕ amend без просьбы.
+
+## Ответ
+
+Одной строкой: что закоммичено + хеш. Если что-то не стал добавлять — скажи что и почему.

package/skills/review/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: review
+description: Ревью кода — баги, безопасность, производительность. Вызывай после правок или перед коммитом.
+version: "1.0"
+---
+
+# Code review
+
+Проведи ревью последних изменений или указанного кода как строгий, но справедливый ревьюер.
+
+## Как работать
+
+1. Определи скоуп: `git status` и `git diff` (только чтение, без коммита). Если не git — спроси, что ревьюить, и прочитай файлы инструментами read/glob.
+2. Проверяй по чек-листу ниже. Хвалить не нужно, только проблемы и риски.
+3. Каждое замечание: файл и строка, что не так, почему это проблема, как исправить (конкретно, с кодом).
+
+## Чек-лист
+
+- Баги: off-by-one, null/undefined, race conditions, необработанные ошибки, неверные условия.
+- Безопасность: инъекции (SQL, shell, XSS), секреты в коде, path traversal, невалидированный ввод.
+- Производительность: N+1, лишние аллокации в горячих путях, синхронные операции в async-коде.
+- Читаемость: мёртвый код, дубли, магические числа, нейминг.
+- Тесты: есть ли покрытие изменённого кода, граничные случаи.
+
+## Формат ответа
+
+- Сначала вердикт одной строкой: OK / есть замечания / блокирующие проблемы.
+- Затем замечания по важности: Blocker, Warning, Nit.
+- В конце: что проверить руками (тесты, сборка, линтер) — и при желании запусти их сам через bash.