code-auditing — скилл для Claude Code: что делает и как установить
Скилл code-auditing для Claude Code проводит пошаговый аудит кодовой базы: находит уязвимости, мёртвый код и технический долг, сверяет вызовы библиотек с официальной документацией.
MIT 1 установок ★ 8 обновлён 2026-09-17
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a claude-codeЧто делает code-auditing
Скилл ведёт аудит по семи фазам — от первичной настройки до итогового отчёта. Сначала агент считывает конфигурационные файлы проекта (package.json, tsconfig.json), определяет стек и снимает базовые показатели текущими линтерами. Затем группирует файлы по модулям, ищет утечки памяти, неблокирующие ошибки промисов, проблемы типизации вроде избыточного типа any и дубликаты логики.
Для проверки мёртвого кода задействуются утилиты knip в проектах на JavaScript и TypeScript или deadcode в Python. При этом скилл требует перепроверять динамические импорты и точки входа сервисов, потому что автоматические сканеры часто принимают серверные обработчики за неиспользуемый код.
В финале формируется файл отчёта с оценкой трудозатрат, списком быстрых правок до 30 минут и рекомендациями по замене самописных решений на готовые библиотеки экосистемы.
Какие задачи решает
- найти уязвимости безопасности вроде SQL-инъекций и захардкоженных секретов
- выявить неиспользуемые импорты, функции и мёртвые файлы через Knip или deadcode
- проверить реализацию библиотек на соответствие официальной документации
- составить приоритизированный план устранения технического долга с оценкой времени
Примеры запросов агенту
- Проведи полный аудит кодовой базы и найди технический долг
- Выполни проверку безопасности и найди мёртвый код в проекте
- Сверь использование внешних библиотек в проекте с их официальной документацией
Как установить code-auditing
1Через Skills CLI (Vercel)
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a claude-code2Вручную: положить файлы
~/.claude/skills/code-auditing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/code-auditing/
1Через Skills CLI (Vercel)
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a codex2Вручную: положить файлы
.agents/skills/code-auditing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a cursor2Вручную: положить файлы
.cursor/skills/code-auditing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeffrigby/somepulp-agents plugins/codebase-health/skills/code-auditing2Вручную: положить файлы
.github/skills/code-auditing/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeffrigby/somepulp-agents --path plugins/codebase-health/skills/code-auditingВручную: положить файлы
.devin/skills/code-auditing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeffrigby/somepulp-agents --skill code-auditing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о code-auditing
Как установить code-auditing в Claude Code?
Выполните команду npx skills add jeffrigby/somepulp-agents --skill code-auditing -a claude-code в терминале.
Какие инструменты нужны скиллу для поиска мёртвого кода?
Для JavaScript и TypeScript запускается npx knip --reporter json, а для проектов на Python используется deadcode . через вызовы Bash.
Как скилл расставляет приоритеты найденным проблемам?
Все находки делятся на уровни Critical, High Priority, Medium Priority, Low Priority, а отдельные мелкие задачи помечаются как Quick Wins со временем исправления до 30 минут.
Исходный текст
SKILL.md · MIT
---
name: code-auditing
description: Systematic methodology for comprehensive codebase analysis — security review, technical debt identification, dead code detection, code quality checks, and best-practices verification against official library documentation.
when_to_use: When the user asks to "audit code", "find technical debt", "perform a security review", "identify dead code", "analyze code quality", "check best practices", or "run a code audit".
allowed-tools: Read, Grep, Glob, Bash, WebSearch, WebFetch
---
# Code Auditing Skill
Comprehensive methodology for systematic code quality audits.
## When to Use
- Comprehensive code quality audits
- Security vulnerability assessments
- Technical debt identification
- Pre-release code reviews
- Best practices verification
- Library and dependency audits
## Audit Phases
### Phase 0: Pre-Analysis Setup
1. Check for project configuration files (package.json, tsconfig.json, etc.)
2. Identify tech stack and main libraries
3. Check for linting/formatting configs
4. Run existing linting/testing commands as baseline
5. Load documentation for identified core libraries
### Phase 1: Discovery
1. Find all code files by type
2. Create tracking list for each file
3. Group files by module/feature for contextual analysis
### Phase 2: File-by-File Analysis
For each file, analyze for:
- Dead code (unused functions, variables, imports)
- Code smells and anti-patterns
- Custom implementations that could use established libraries
- Security vulnerabilities
- Performance issues
- Outdated patterns or deprecated APIs
- Missing error handling
- Overly complex functions
- Duplicate code
### Phase 3: Best Practices Verification
For every library and framework:
1. Retrieve official documentation
2. Compare implementation against official patterns
3. Identify deviations from recommendations
4. Note outdated usage patterns
5. Flag discouraged anti-patterns
### Phase 4: Pattern Detection
Look for recurring issues:
- Common anti-patterns across files
- Duplicated logic that could be abstracted
- Inconsistent coding styles
- Missing error handling patterns
### Phase 5: Library Recommendations
For custom implementations:
1. Check if current libraries provide the functionality
2. Search for mature ecosystem packages
3. Verify library health (commits, issues, activity)
4. Check compatibility with project setup
### Phase 6: Comprehensive Report
Generate detailed report with:
- Executive summary
- Critical issues requiring immediate attention
- File-by-file findings
- Prioritized action plan
- Effort estimates
- Library recommendations
## Issue Priority Levels
- **Critical** - Security vulnerabilities, broken functionality
- **High Priority** - Performance bottlenecks, unmaintainable code
- **Medium Priority** - Code quality, best practices deviations
- **Low Priority** - Style, minor improvements
- **Quick Wins** - Less than 30 minutes to fix
## Analysis Categories
### Security
- Hardcoded secrets
- SQL injection risks
- XSS vulnerabilities
- Missing input validation
- Exposed sensitive data
### Performance
- Inefficient algorithms
- Blocking operations
- Memory leaks
- Missing caching opportunities
- N+1 query patterns
### TypeScript/Type Safety
- Missing type annotations
- Use of `any` type
- Custom types duplicating official types
- Missing @types packages
### Async/Promise Issues
- Missing await keywords
- Unhandled promise rejections
- Callback hell
### Dead Code
- Unused imports and exports
- Unused functions, classes, and methods
- Unused variables and types
- Unreachable code blocks
- Unused files (not imported anywhere)
- Unused dependencies
**Tools:**
- JavaScript/TypeScript: `npx knip --reporter json`
- Python: `deadcode .`
**Important:** Always verify tool findings before reporting. Check for:
- Dynamic imports (`import(variable)`)
- Framework patterns (React components, decorators)
- Re-exports for public API
- Entry points (CLI scripts, serverless handlers)
## Resources
See the reference documents for complete methodologies:
- `${CLAUDE_SKILL_DIR}/references/audit-methodology.md` - Full 6-phase audit process with detailed checklists
- `${CLAUDE_SKILL_DIR}/references/dead-code-methodology.md` - Dead code detection tools, verification, and cleanup workflows
## Quick Reference
### Before Starting
- [ ] Read project configuration files
- [ ] Identify tech stack and libraries
- [ ] Run existing linters as baseline
- [ ] Create file tracking list
### During Audit
- [ ] Mark files as in-progress
- [ ] Analyze each category systematically
- [ ] Note specific line numbers
- [ ] Document before/after examples
- [ ] Mark files as completed
### After Audit
- [ ] Categorize all findings by priority
- [ ] Generate comprehensive report
- [ ] Save report to project root
- [ ] Provide brief console summary
© jeffrigby · MIT · jeffrigby/somepulp-agents