{"slug":"pack","title":"pack","summary":"Package a contribution (gist, script, fix or skill) as a product instead of a bare snippet: README with problem and result, install steps, a test, license, honest limits and a clear entry point. Use before publishing a gist, sharing a fix or releasing a slice of internal tooling.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-29T19:13:03.851334Z","repo":{"url":"https://github.com/tonydzi/second-brain-starter-kit","stars":15,"forks":5,"license":"MIT","updatedAt":"2026-11-19T13:51:48Z"},"bodyHtml":"<hr>\n<h2>name: pack\ndescription: \"Package a contribution (gist, script, fix or skill) as a product instead of a bare snippet: README with problem and result, install steps, a test, license, honest limits and a clear entry point. Use before publishing a gist, sharing a fix or releasing a slice of internal tooling. Triggers: /pack, package this properly, make it a product, ship it with quality.\"\nlicense: MIT\nversion: 1.0.0</h2>\n<h1>/pack — не сниппет, а продукт</h1>\n<p><strong>Зачем существует:</strong> сниппет решает задачу автора; продукт решает задачу ЧУЖОГО человека,\nкоторый видит его впервые, не знает контекста и не будет спрашивать. Каждый наш артефакт\nнаружу — витрина лаборатории (Mission-2): по нему судят, брать ли нас всерьёз.\nЭталон: workdir-sentry 24.08.2026 — v1 (сниппет: код + 2 строки) → v2 (продукт).</p>\n<h2>Шаг 0 — что пакуем и для кого (30 секунд, письменно в чате)</h2>\n<p>Одной строкой: артефакт · чужой пользователь (кто он, что у него болит) · формат\n(gist / repo / файл в тред). Если пользователь = «мы сами» → /pack не нужен, не наряжай ёлку.</p>\n<h2>Шаг 1 — README = продукт (главная половина, порядок обязателен)</h2>\n<p>Чужой человек читает README, не код. Скелет — СТРОГО в этом порядке:</p>\n<ol>\n<li><strong>Одно предложение жирным</strong>: что это и какую боль снимает.</li>\n<li><strong>Боль с УЗНАВАЕМЫМИ симптомами</strong> — как жалуется страдалец своими словами\n(«Claude ignores my CLAUDE.md», «my history disappeared»), не наша терминология.</li>\n<li><strong>Цифры/замер</strong> — почему боль реальна. ТОЛЬКО наши доказанные числа\n([[fake-it-courage-not-fake-numbers]]); таблица лучше абзаца.</li>\n<li><strong>Самодиагностика за 30 секунд</strong> — как читателю понять, что это ЕГО болезнь\n(одна команда / куда посмотреть). Это самый конвертирующий блок.</li>\n<li><strong>Как чинит</strong> — механизм по-человечески + пример реального выхлопа (цитата warning-строки).</li>\n<li><strong>Design choices / safety contract</strong> — почему нам можно доверять в чужом hook-чейне:\nfail-open? zero deps? что НЕ делает?</li>\n<li><strong>Install пошагово</strong> — по ОС, копипастные блоки, с проверкой «как убедиться, что работает».</li>\n<li><strong>FAQ</strong> — 3-5 вопросов, которые задаст скептик (почему warn а не block? работает ли в X?).</li>\n<li><strong>Атрибуция + лицензия</strong>: «by Mycroft (synthetic cofounder) &amp; Tony, Palo Alto AI Research\nLab» + MIT. Раскрытие Майкрофта = §3.3.\n9-бис. ⭐ ПОДПИСЬ И КОНТАКТЫ — НЕ «ГДЕ УМЕСТНО», А ВСЕГДА (anton 10.09, голосовая hub:6539).\nПак = публичная поверхность, значит README/карточка несут <strong>полный блок</strong> (кто мы +\n<code>github.com/tonydzi</code> + WhatsApp + группа). Единственный источник текста:\n<code>$OBSIDIAN_VAULT/08-Templates/github-touch-signature.md</code> §Полный блок; карта поверхностей\n(что куда) = <code>$OBSIDIAN_VAULT/08-Templates/outbound-signature.md</code>. Прежняя формулировка\n«где уместно» была дырой: замер 10.09 — 94% наших GitHub-касаний ушли без ссылки на нас.\n⚠️ Научная поверхность (arXiv/Zenodo/JOSS/CITATION.cff) = исключение: там\n<code>Anton Dziatkovskii (Tony Dzi)</code> + ORCID, без CTA.</li>\n</ol>\n<h2>Шаг 2 — код = продукт</h2>\n<ul>\n<li><strong>Докстринг-шапка</strong>: WHY THIS EXISTS → WHAT IT DOES → SAFETY CONTRACT → USAGE → CONFIG.\nЧеловек должен понять файл, не читая тела.</li>\n<li><strong>Комментарии объясняют ЗАЧЕМ, не что</strong>: у каждого неочевидного хода — причина, лучше с\nграблей («PowerShell 5.1 pipes prepend U+FEFF — this exact byte broke two of our tools»).</li>\n<li><strong><code>--selftest</code> встроен</strong>: встроенные кейсы, PASS/FAIL, exit 0/1 — читатель проверяет ДО\nустановки. <strong><code>--check &lt;вход&gt;</code></strong> — сухой прогон одного случая руками, где применимо.</li>\n<li><strong>Ядро = чистая функция</strong> (без I/O/env) — тестируемо и переносимо в чужой стек.</li>\n<li><strong>Zero dependencies, один файл</strong> где возможно (АК-47); английский; generic-имена.</li>\n</ul>\n<h2>Шаг 3 — гейт перед публикацией (все пункты, молча скипать нельзя)</h2>\n<ul>\n<li><input disabled=\"disabled\" type=\"checkbox\"> <code>--selftest</code> прогнан СЕЙЧАС, PASS (не «прогонял раньше»).</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Запуск с чистого листа: из пустой папки / без нашего конфига — падает вежливо, не трейсбеком.</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Leak-scan глазами: ни секретов, ни внутренних имён узлов/людей/путей, ни приватных цифр.</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Цифры в README = правда с источником; непроверенное помечено \uD83E\uDD14 прямо в тексте.</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> После пуша — проверь, что ДОЕХАЛО (размеры/содержимое; грабля 24.08: <code>gh gist edit --add</code>\nмолча НЕ обновил существующий файл, чинилось <code>gh api PATCH</code>).</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> <strong>Формат repo — прибором, не глазами</strong> (только если пакуем в репозиторий):\n<code>python ~/.claude/scripts/repo_birth_kit.py --check &lt;папка&gt;</code> → exit 0. Красный\nназывает поимённо: нет файла · скелет с TODO не дописан · файл не в git (push его\nне отправит). Замер 09.09.2026: 7 из 7 репо родились без CITATION.cff/FOR-ROBOTS.md.</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Формат по размеру: сниппет-масштаб → gist; растёт/ждём вклада → repo. Каталоги\n(awesome-list и т.п.) — их CONTRIBUTING читается ЦЕЛИКОМ, подача ровно по их формату.</li>\n</ul>\n<h2>Шаг 4 — вердикт (строка в отчёт)</h2>\n<p>«\uD83D\uDCE6 упаковано: &lt;артефакт&gt; · README 9/9 блоков · selftest PASS · leak-scan ✅ · формат &lt;gist/repo&gt;»\nлибо честное «\uD83D\uDCE6 не дотянул: &lt;чего не хватает&gt;» — полуфабрикат наружу не выходит.\nДальше раздача = /share-fix (этот скилл НЕ решает, куда нести).</p>\n<h2>⭐ Чёрный юмор обязателен (anton 10.09.2026, голосом)</h2>\n<p>Любой текст, который этот скилл отправляет ЖИВОМУ человеку наружу, несёт чёрную самоиронию — ровный служебный тон = дефект, объяснять надо не шутку, а её отсутствие. Строку берёшь через <code>/mycroft-joke</code> (полка (д) банка + строки 56-62 под холодное касание), приёмка — <code>/taste-check</code> P36. ⛔ Не шутим ровно в трёх зонах, и они не про вкус: строго-научная публикация (arXiv/журнал/JOSS) · юр.обязательство и анкета · красный список банка (чужая иконография угнетённых, псевдо-слуры, отрицание что я ИИ, юмор поверх диагноза/денег/беды собеседника). Одна шутка на тред. Канон: CLAUDE.md §3.3 §Поправка 10.09 + [[dark-humor-default-everywhere-external]].</p>\n\n<hr>\n<p><strong>Like this skill?</strong> It is part of <a href=\"https://github.com/tonydzi/second-brain-starter-kit\">second-brain-starter-kit</a>: the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with <code>npx skills add tonydzi/second-brain-starter-kit</code>. Everything is open source and free, so take what you need.</p>\n<p>Flagships worth a look on their own: <a href=\"https://github.com/tonydzi/secondop-panel\">secondop-panel</a> (a second opinion from a panel of external models), <a href=\"https://github.com/tonydzi/claude-memory-tidy\">claude-memory-tidy</a> (stop your agent's memory from rotting), <a href=\"https://github.com/tonydzi/telegram-mcp-kit\">telegram-mcp-kit</a> (your own Telegram over MCP in about 15 minutes).</p>\n<p>Author: <strong>Anton Dziatkovskii</strong>, Palo Alto AI Research Lab. Telegram <a href=\"https://t.me/tonydzi\">@tonydzi</a> - WhatsApp <a href=\"https://wa.me/13412229178\">+1 341 222 9178</a> - X <a href=\"https://x.com/Tony_Stef_\">@Tony_Stef_</a></p>\n<p><strong>Engineers: want to test-drive this setup?</strong> Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.</p>\n","files":[{"path":"SKILL.md","sizeBytes":9721,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-29T19:25:17.632375Z","sha256":"2D03FE41396282C9D08CB1428ABA16862ACE84F8E1D85E4E13EA2CAD856681D7","sizeBytes":4903},"review":null,"source":{"repositoryUrl":"https://github.com/tonydzi/second-brain-starter-kit","path":"skills/pack","license":"MIT","commit":"fdb53d7f98ebafccbe3daf2dac0d5fa3600eb282","subtreeSha":"B42D1440A53A23FC5BBC10217EFDD9FA3FBB321DACCC75583FD17033A9C9C8E6","lastSyncedAt":"2026-11-19T20:10:55.345847Z"},"reviewedAt":"2026-10-29T19:25:37.17277Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/tonydzi/second-brain-starter-kit/tree/master/skills/pack"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tonydzi-second-brain-starter-kit@llmmart"},{"target":"git","command":"git clone https://github.com/tonydzi/second-brain-starter-kit.git"}]}