القائمة
Паттерн организации файлов скилла: SKILL.md + подпапки для скриптов/ресурсов. Никогда не держать инлайн-код в SKILL.md — выносить в scripts/.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Pragmatic coding principles: SOLID, KISS, DRY, YAGNI in balance. Use when writing code, refactoring, reviewing, or designing architecture. Prevents over-engineering while maintaining code quality. Триггеры: "напиши код", "рефактори", "code review", "архитектура", "engineering principles", "SOLID", "KISS", "DRY", "YAGNI", "design this", "how to structure", "разбей на модули", "спроектируй архитектуру", "создай проект", "структура проекта", "объясни архитектуру"
Запуск скриптов, серверов, тестов, билдов на лету. Реалтайм-мониторинг, точечная остановка процессов, отладка по ходу выполнения. Триггеры: «запусти», «прогони», «проверь», «почини», «останови», «посмотри логи», «на ходу», «реалтайм», «realtime», «на лету», «мониторь», «отслеживай», «проверяй в процессе».
Стратегия логирования, форматы, уровни, отладка через логи, поиск edge cases и багов. Триггеры: «добавь логи», «логирование», «trace», «отслеживай баг», «edge case», «найди причину», «почему упало», «что тут произошло», «логирование в продакшене».
Создание кастомных субагентов для ЛЮБОГО AI CLI: Qwen Code, Codex, Claude Code, Factory Droid, Gemini CLI, OpenCode, GitHub Copilot CLI. Use when: создать агент, subagent, custom agent, сабагент, агент для CLI, кастомный субагент, agent for CLI, copilot agent
Scan code for security vulnerabilities, leaked secrets, and dependency issues using the Autofix Bot API (api.autofix.bot), and auto-fix detected issues. Use this skill when asked to: (1) Scan or analyze a repository or code for security issues, secrets, or vulnerabilities using Autofix Bot, (2) Upload/sync a local git repository to Autofix Bot for analysis, (3) Run Autofix Bot on code changes, pull requests, or patches, (4) Apply auto-fixes from Autofix Bot analysis results. Requires an Autofix Bot API key (environment variable AUTOFIX_BOT_API_KEY).
Retrieve code review results from DeepSource — issues, vulnerabilities, report cards, and analysis runs. Use when asked about code quality, security findings, dependency CVEs, coverage metrics, or analysis status.
| name | skill-file-structure |
| description | Паттерн организации файлов скилла: SKILL.md + подпапки для скриптов/ресурсов. Никогда не держать инлайн-код в SKILL.md — выносить в scripts/. |
| triggers | ["структура скилла","как организовать скилл","файлы скилла","skill structure","куда положить скрипт"] |
НИКОГДА не размещай длинные скрипты, шаблоны или код прямо в SKILL.md.
.agents/skills/<skill-name>/
├── SKILL.md # Описание, правила, триггеры
├── scripts/ # Исполняемые скрипты
│ ├── audit.sh
│ └── setup.sh
├── templates/ # Шаблоны файлов
│ └── .env.example
└── README.md # Документация (опционально)
| Проблема инлайн-кода в SKILL.md | Решение с подпапками |
|---|---|
| SKILL.md раздувается до 300+ строк | SKILL.md компактный, только правила |
| Скрипт нельзя запустить напрямую | scripts/foo.sh — исполняемый файл |
| Сложно обновлять скрипт отдельно | Скрипт живёт в своём файле |
| YAML фронтматтер ломается от спецсимволов в коде | Чистый YAML, код в отдельных файлах |
Если в SKILL.md есть секция с длинным скриптом (bash, python, ts и т.д.):
scripts/ рядом с SKILL.mdscripts/<имя>.sh (или .py, .ts)## audit-gitignore.sh
Скрипт: `scripts/audit-gitignore.sh`
Проверяет:
- Какие файлы игнорируются
- Скан на секреты
- Рекомендации
<details> с кодом скриптаchmod +x scripts/*.shДо (плохо): SKILL.md = 364 строки, 120 из них — bash-скрипт в блоке кода.
После (хорошо): SKILL.md = 247 строк, scripts/audit-gitignore.sh = 110 строк отдельно.
| Подпапка | Назначение |
|---|---|
scripts/ | Исполняемые скрипты (bash, python, node) |
templates/ | Шаблоны для копирования (.env.example, LICENSE и т.д.) |
assets/ | Ресурсы: изображения, иконки |
examples/ | Примеры использования |
prompts/ | Промпты для разных сценариев |
mkdir -p .agents/skills/<name>/scriptsscripts/chmod +x scripts/*.sh