메뉴
Паттерн организации файлов скилла: 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