Безопасность аудита CLI для навыков агента ИИ.

Агенты ИИ все чаще используют «навыки» — модульные пакеты, содержащие инструкции и исполняемый код, расширяющие возможности агента. Эти навыки могут выполнять код на вашем компьютере, что делает их значительным риском безопасности, если они не проверены должным образом.

Квалификационный аудит помогает вам проверить навыки, прежде чем доверять им.

Особенности

** Быстрое обнаружение инъекций** - Сканирование описаний навыков для джейлбрейка и попыток манипулирования

• ) Secret Scanning - Найдены жестко закодированные ключи API, токены и учетные данные (через trufflehog/gitleaks)
• )Shell Script Analysis - Проверка сценариев bash на наличие опасных шаблонов (через shellcheck) Code Security - Анализ Python/JS кода для проблем безопасности (через semgrep)
• SARIF Output - готовый выходной формат CI/CD для интеграции GitHub Actions ** Расширяемый ** - архитектура плагина для пользовательских сканеров

##Установка

Макарон

Добавить в профиль оболочки (необязательно для глобального доступа):

Linux

###От PyPI

Использование

###Базовый аудит

Формы выхода

###Проверка доступных инструментов

###Строгий режим

Что проверяется

###Быстрый/инструментальный анализ

skill-audit

🔒 Security auditing CLI for AI agent skills.

AI agents increasingly use “skills” - modular packages containing instructions and executable code that extend an agent’s capabilities. These skills can execute code on your machine, making them a significant security risk if not properly vetted.

skill-audit helps you audit skills before trusting them.

Features

• 🔍 Prompt Injection Detection - Scans skill descriptions for jailbreak patterns and manipulation attempts
• 🔑 Secret Scanning - Finds hardcoded API keys, tokens, and credentials (via trufflehog/gitleaks)
• 🐚 Shell Script Analysis - Checks bash scripts for dangerous patterns (via shellcheck)
• 🐍 Code Security - Analyzes Python/JS code for security issues (via semgrep)
• 📄 SARIF Output - CI/CD ready output format for GitHub Actions integration
• 🔌 Extensible - Plugin architecture for custom scanners

Installation

macOS

# 1. Clone the repo
git clone https://github.com/markpors/skill-audit
cd skill-audit

# 2. Create virtual environment and install
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# 3. Install security tools (recommended)
brew install shellcheck semgrep trufflehog

# Note: gitleaks is an alternative to trufflehog (only need one)
# brew install gitleaks

# 4. Verify installation
skill-audit check-tools

Add to your shell profile (optional, for global access):

# Add to ~/.zshrc or ~/.bashrc
alias skill-audit="source ~/dev/skill-audit/.venv/bin/activate && skill-audit"

Linux

# 1. Clone and install
git clone https://github.com/markpors/skill-audit
cd skill-audit
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# 2. Install security tools
pip install semgrep
sudo apt install shellcheck  # Debian/Ubuntu
# For trufflehog: https://github.com/trufflesecurity/trufflehog#installation

From PyPI

pip install skill-audit

Usage

Basic Audit

# Audit a skill directory
skill-audit audit ./my-skill/

# Audit a specific file
skill-audit audit ./my-skill/SKILL.md

Output Formats

# Pretty terminal output (default)
skill-audit audit ./my-skill/

# JSON output
skill-audit audit ./my-skill/ --format json

# SARIF output (for CI/CD)
skill-audit audit ./my-skill/ --format sarif -o results.sarif

Check Available Tools

skill-audit check-tools

Strict Mode

# Fail on warnings (not just errors)
skill-audit audit ./my-skill/ --strict

What It Checks

Prompt/Instruction Analysis

• Jailbreak patterns (“ignore previous instructions”, “DAN mode”, etc.)
• Role manipulation attempts (“you are root”, “pretend to be admin”)
• Data exfiltration instructions
• Safety bypass attempts

Code Analysis

• Hardcoded secrets and credentials
• Dangerous shell patterns (rm -rf, eval, etc.)
• Arbitrary code execution risks
• Subprocess injection vulnerabilities

Exit Codes