skill-generalizer — скилл для Claude Code: публикация личных скиллов
Превращает локальный скилл в публичный: убирает личные пути, привычки и учётные данные, оставляя рабочую технику. Пригодится перед выкладкой на GitHub или в маркетплейс.
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a claude-codeЧто делает skill-generalizer
Скилл проводит скилл через подготовку к публикации: сначала смотрит исходник и соседние файлы репозитория, потом отделяет переносимую технику от личных деталей реализации. Приватные имена, пути, хосты, учётные данные, ID аккаунтов и разовые факты проекта вычищаются или заменяются. Дальше текст переписывается вокруг общих условий запуска и переносимых шагов.
Внутри два справочника: references/publication-rubric.md — для полного прохода по релизу, редактуры README и упаковки, references/platform-compatibility.md — его читают до заявлений о поддержке Codex, Claude, Cursor, OpenCode, Gemini CLI и других агентов. SKILL.md держат коротким, длинные рубрики и примеры уходят в bundled-ресурсы.
Перед установкой проверьте, что у вас есть npx и доступ к GitHub: без них команда npx skills add не сработает. Скилл не подходит для тонкой настройки под свою машину — для этого в том же репозитории есть skill-personalizer.
Какие задачи решает
- выложить личный скилл на GitHub без утечки приватных путей
- заменить внутренние хосты и ID аккаунтов на переносимые плейсхолдеры
- переписать описание скилла под общие условия запуска
- проверить совместимость скилла с целевым агентом до заявлений о поддержке
- собрать README и упаковку для маркетплейса, где заявления совпадают с файлами
Примеры запросов агенту
- Прогони skill-generalizer по моему скиллу в
~/.claude/skills/deploy-helper— хочу выложить его на GitHub - Проверь
SKILL.mdиreferences/на приватные пути и учётные данные перед публикацией - Собери публичную версию скилла и проверь совместимость с Claude и Cursor
Как установить skill-generalizer
1Через Skills CLI (Vercel)
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-generalizer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-generalizer/
1Через Skills CLI (Vercel)
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a codex2Вручную: положить файлы
.agents/skills/skill-generalizer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a cursor2Вручную: положить файлы
.cursor/skills/skill-generalizer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hqhq1025/skill-optimizer skill-generalizer2Вручную: положить файлы
.github/skills/skill-generalizer/SKILL.md1Через Skills CLI (Vercel)
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a gemini-cli2Командой платформы
gemini skills install https://github.com/hqhq1025/skill-optimizer --path skills/skill-generalizerВручную: положить файлы
.devin/skills/skill-generalizer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skill-generalizer
Как установить skill-generalizer в Claude Code?
Выполните npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a claude-code. Скилл встанет в ~/.claude/skills/skill-generalizer/SKILL.md.
Что делает skill-generalizer?
Готовит локальный скилл к публикации: вычищает приватные пути, хосты, учётные данные и личные привычки, переписывает текст под общие условия запуска.
Чем он отличается от skill-personalizer?
skill-generalizer нужен для публикации скилла наружу, skill-personalizer — для настройки скилла под вашу собственную машину.
Исходный текст
SKILL.md · MIT
--- name: skill-generalizer description: Use when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal habits, credentials, internal hosts, or user-specific context must be removed. --- # Skill Generalizer ## Overview Convert a working local skill into a clean public artifact. The goal is to preserve the reusable technique while removing private context, personal assumptions, and machine-specific setup. ## When To Use - A user wants to publish, share, promote, open-source, or package a local skill. - A skill was born from personal workflows, private repos, local paths, transcripts, remote hosts, or team conventions. - The output needs to be useful to strangers without leaking the author's environment. Do not use for tuning a skill only for the user's own machine; use `skill-personalizer` for that. ## Workflow 1. Inspect the actual source skill and nearby repo files before judging. 2. If the source skill quality is unclear, run the audit checks from `skill-personalizer` first. 3. Separate the reusable capability from personal implementation details. 4. Redact or replace private names, paths, hosts, credentials, account IDs, transcripts, and one-off project facts. 5. Rewrite the skill around general triggering conditions, portable workflows, and bounded assumptions. 6. Keep `SKILL.md` concise; move long rubrics, examples, or scripts into bundled resources. 7. Check target-agent compatibility before writing install instructions or support claims. 8. Produce publication-ready packaging and honest promotion copy only when requested. 9. Verify frontmatter, file layout, install path, and at least one realistic usage prompt. ## Public Release Rules - Frontmatter `description` should describe when to use the skill, not summarize its workflow. - Public examples must be generic or explicitly sanitized. - Claims in README or marketplace copy must match files that actually exist. - Prefer portable commands and path placeholders over the author's home directory or private aliases. - If a personal detail is essential, turn it into a configurable variable with setup guidance. ## References Read [publication-rubric.md](references/publication-rubric.md) when doing a full release pass, redaction review, README rewrite, or promotional packaging. Read [platform-compatibility.md](references/platform-compatibility.md) before claiming support for Codex, Claude Code, Cursor, OpenCode, Gemini CLI, or other coding agents.
© hqhq1025 · MIT · hqhq1025/skill-optimizer