К основному содержанию
скилл CX Codex

prowler-sdk-check — скилл для Claude Code

Скилл prowler-sdk-check для Claude Code, Codex, Cursor и других IDE помогает писать проверки безопасности Prowler по архитектурным паттернам SDK.

Apache-2.0 ★ 15 302 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add prowler-cloud/prowler --skill prowler-sdk-check -a claude-code
Открыть на GitHub

Что делает prowler-sdk-check

Prowler — фреймворк для аудита безопасности облачной инфраструктуры. Скилл помогает создавать новые проверки (checks), которые проверяют конкретные требования безопасности. Работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

Скилл генерирует три файла: класс проверки на Python (логика аудита), JSON с метаданными (описание, риски, способы исправления) и инициализационный файл. Предусмотрены команды для локального запуска проверки и списка всех проверок по имени. При создании или обновлении проверки скилл срабатывает автоматически.

Проверка должна возвращать PASS, FAIL или MANUAL. Если данные недоступны из-за отсутствия прав на API или лицензии — это не ошибка, а статус MANUAL с пояснением. Скилл содержит шаблон класса, описание всех полей метаданных (включая рекомендации по severity и категориям) и примеры команд для AWS, Terraform и CloudFormation.

Какие задачи решает

  • написать проверку безопасности в Prowler по правилам SDK
  • сгенерировать структуру файлов и метаданные для новой проверки
  • создать проверку для AWS, Azure, GCP, Kubernetes или другого провайдера
  • исправить существующую проверку и обновить её метаданные
  • валидировать проверку локально перед коммитом

Примеры запросов агенту

  • Создай проверку Prowler для EC2: убедись, что инстансы не имеют публичного IP
  • Напиши скилл-проверку для S3: убедись, что шифрование включено во всех бакетах
  • Обнови метаданные проверки IAM: добавь ссылки на документацию AWS и способы исправления

Как установить prowler-sdk-check

1Через Skills CLI (Vercel)

npx skills add prowler-cloud/prowler --skill prowler-sdk-check -a claude-code

2Вручную: положить файлы

~/.claude/skills/prowler-sdk-check/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/prowler-sdk-check/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о prowler-sdk-check

Как установить prowler-sdk-check в Claude Code?

Выполни две команды по порядку: сначала npx skills add prowler-cloud/prowler --skill prowler-sdk-check -a claude-code, потом открой ~/.claude/skills/prowler-sdk-check/SKILL.md для проверки установки.

Что делает prowler-sdk-check?

Скилл генерирует структуру папок, класс проверки на Python и JSON-файл с метаданными. Содержит шаблоны, примеры полей и рекомендации по severity и категориям. Помогает следовать архитектурным паттернам SDK Prowler при создании и обновлении проверок безопасности.

Какие провайдеры поддерживает prowler-sdk-check?

Скилл работает с AWS, Azure, GCP, Kubernetes, GitHub и M365. Структура и процесс создания проверки одинаковые для всех провайдеров; различаются только имена сервисов и методы получения данных.

Исходный текст

SKILL.md · Apache-2.0
---
name: prowler-sdk-check
description: >
  Creates Prowler security checks following SDK architecture patterns.
  Trigger: When creating or updating a Prowler SDK security check (implementation + metadata) for any provider (AWS, Azure, GCP, K8s, GitHub, etc.).
license: Apache-2.0
metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [root, sdk]
  auto_invoke:
    - "Creating new checks"
    - "Updating existing checks and metadata"
allowed-tools: Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch, Task
---

## Check Structure

```text
prowler/providers/{provider}/services/{service}/{check_name}/
├── __init__.py
├── {check_name}.py
└── {check_name}.metadata.json
```

---

## Step-by-Step Creation Process

### 1. Prerequisites

- **Verify check doesn't exist**: Search `prowler/providers/{provider}/services/{service}/`
- **Ensure provider and service exist** - create them first if not
- **Confirm service has required methods** - may need to add/modify service methods to get data

### 2. Create Check Files

```bash
mkdir -p prowler/providers/{provider}/services/{service}/{check_name}
touch prowler/providers/{provider}/services/{service}/{check_name}/__init__.py
touch prowler/providers/{provider}/services/{service}/{check_name}/{check_name}.py
touch prowler/providers/{provider}/services/{service}/{check_name}/{check_name}.metadata.json
```

### 3. Implement Check Logic

```python
from prowler.lib.check.models import Check, Check_Report_{Provider}
from prowler.providers.{provider}.services.{service}.{service}_client import {service}_client

class {check_name}(Check):
    """Ensure that {resource} meets {security_requirement}."""
    def execute(self) -> list[Check_Report_{Provider}]:
        """Execute the check logic.

        Returns:
            A list of reports containing the result of the check.
        """
        findings = []
        for resource in {service}_client.{resources}:
            report = Check_Report_{Provider}(metadata=self.metadata(), resource=resource)
            report.status = "PASS" if resource.is_compliant else "FAIL"
            report.status_extended = f"Resource {resource.name} compliance status."
            findings.append(report)
        return findings
```

### 4. Create Metadata File

See complete schema below and `assets/` folder for complete templates.
For detailed field documentation, see `references/metadata-docs.md`.

### 5. Verify Check Detection

```bash
uv run python prowler-cli.py {provider} --list-checks | grep {check_name}
```

### 6. Run Check Locally

```bash
uv run python prowler-cli.py {provider} --log-level ERROR --verbose --check {check_name}
```

### 7. Create Tests

See `prowler-test-sdk` skill for test patterns (PASS, FAIL, no resources, error handling).

---

## Check Naming Convention

```text
{service}_{resource}_{security_control}
```

Examples:
- `ec2_instance_public_ip_disabled`
- `s3_bucket_encryption_enabled`
- `iam_user_mfa_enabled`

---

## Metadata Schema (COMPLETE)

```json
{
  "Provider": "aws",
  "CheckID": "{check_name}",
  "CheckTitle": "Human-readable title",
  "CheckType": [
    "Software and Configuration Checks/AWS Security Best Practices",
    "Software and Configuration Checks/Industry and Regulatory Standards/AWS Foundational Security Best Practices"
  ],
  "ServiceName": "{service}",
  "SubServiceName": "",
  "ResourceIdTemplate": "",
  "Severity": "low|medium|high|critical",
  "ResourceType": "AwsEc2Instance|Other",
  "ResourceGroup": "security|compute|storage|network",
  "Description": "**Bold resource name**. Detailed explanation of what this check evaluates and why it matters.",
  "Risk": "What happens if non-compliant. Explain attack vectors, data exposure risks, compliance impact.",
  "RelatedUrl": "",
  "AdditionalURLs": [
    "https://docs.aws.amazon.com/..."
  ],
  "Remediation": {
    "Code": {
      "CLI": "aws {service} {command} --option value",
      "NativeIaC": "```yaml\nResources:\n  Resource:\n    Type: AWS::{Service}::{Resource}\n    Properties:\n      Key: value  # This line fixes the issue\n```",
      "Other": "1. Console steps\n2. Step by step",
      "Terraform": "```hcl\nresource \"aws_{service}_{resource}\" \"example\" {\n  key = \"value\"  # This line fixes the issue\n}\n```"
    },
    "Recommendation": {
      "Text": "Detailed recommendation for remediation.",
      "Url": "https://hub.prowler.com/check/{check_name}"
    }
  },
  "Categories": [
    "identity-access",
    "encryption",
    "logging",
    "forensics-ready",
    "internet-exposed",
    "trust-boundaries"
  ],
  "DependsOn": [],
  "RelatedTo": [],
  "Notes": ""
}
```

### Required Fields

| Field | Description |
|-------|-------------|
| `Provider` | Provider name: aws, azure, gcp, kubernetes, github, m365 |
| `CheckID` | Must match class name and folder name |
| `CheckTitle` | Human-readable title |
| `Severity` | `low`, `medium`, `high`, `critical` |
| `ServiceName` | Service being checked |
| `Description` | What the check evaluates |
| `Risk` | Security impact of non-compliance |
| `Remediation.Code.CLI` | CLI fix command |
| `Remediation.Recommendation.Text` | How to fix |

### Severity Guidelines

| Severity | When to Use |
|----------|-------------|
| `critical` | Direct data exposure, RCE, privilege escalation |
| `high` | Significant security risk, compliance violation |
| `medium` | Defense-in-depth, best practice |
| `low` | Informational, minor hardening |

---

## Check Report Statuses

| Status | When to Use |
|--------|-------------|
| `PASS` | Resource is compliant |
| `FAIL` | Resource is non-compliant |
| `MANUAL` | Requires human verification, or the data needed to evaluate the resource could not be retrieved |

### Permission / availability errors are NOT findings

Never set `FAIL` because an API call failed (missing permission or scope, API not enabled, feature not licensed, data unavailable). That is a scan-configuration problem, not a security issue, and it surfaces as a misleading high-severity finding.

- Service: log the error and expose it distinctly from an empty result (`None` instead of `[]`, an `*_error` attribute, or a `*_lookup_failed` set). Only treat real access errors this way; a `404`/not-found usually means "not configured" and IS a legitimate `FAIL`, and a definitively disabled API is a legitimate `FAIL` when the API's activation is itself the audited control (e.g. GCP Access Approval).
- Check: emit ONE tenant/account/project/subscription-level `MANUAL` finding (not one per resource) whose `status_extended` says the check cannot be evaluated and names the required permission/API/license.
- Do not touch `report.check_metadata.Severity` to hide it.

```python
if <service>_client.<data> is None:
    report = CheckReport<Provider>(metadata=self.metadata(), resource={})
    report.resource_name = "<Tenant-level resource>"
    report.resource_id = "<stable-id>"
    report.status = "MANUAL"
    report.status_extended = "Cannot evaluate <requirement>: <data> could not be retrieved. Verify that <permission> is granted to the scanning identity."
    return [report]
```

---

## Common Patterns

### AWS Check with Regional Resources

```python
from prowler.lib.check.models import Check, Check_Report_AWS
from prowler.providers.aws.services.s3.s3_client import s3_client

class s3_bucket_encryption_enabled(Check):
    def execute(self) -> list[Check_Report_AWS]:
        findings = []
        for bucket in s3_client.buckets.values():
            report = Check_Report_AWS(metadata=self.metadata(), resource=bucket)
            if bucket.encryption:
                report.status = "PASS"
                report.status_extended = f"S3 bucket {bucket.name} has encryption enabled."
            else:
                report.status = "FAIL"
                report.status_extended = f"S3 bucket {bucket.name} does not have encryption enabled."
            findings.append(report)
        return findings
```

### Check with Multiple Conditions

```python
from prowler.lib.check.models import Check, Check_Report_AWS
from prowler.providers.aws.services.ec2.ec2_client import ec2_client

class ec2_instance_hardened(Check):
    def execute(self) -> list[Check_Report_AWS]:
        findings = []
        for instance in ec2_client.instances:
            report = Check_Report_AWS(metadata=self.metadata(), resource=instance)

            issues = []
            if instance.public_ip:
                issues.append("has public IP")
            if not instance.metadata_options.http_tokens == "required":
                issues.append("IMDSv2 not enforced")

            if issues:
                report.status = "FAIL"
                report.status_extended = f"Instance {instance.id} {', '.join(issues)}."
            else:
                report.status = "PASS"
                report.status_extended = f"Instance {instance.id} is properly hardened."

            findings.append(report)
        return findings
```

---

## Commands

```bash
# Verify detection
uv run python prowler-cli.py {provider} --list-checks | grep {check_name}

# Run check
uv run python prowler-cli.py {provider} --log-level ERROR --verbose --check {check_name}

# Run with specific profile/credentials
uv run python prowler-cli.py aws --profile myprofile --check {check_name}

# Run multiple checks
uv run python prowler-cli.py {provider} --check {check1} {check2} {check3}
```

## Resources

- **Templates**: See [assets/](assets/) for complete check and metadata templates (AWS, Azure, GCP)
- **Documentation**: See [references/metadata-docs.md](references/metadata-docs.md) for official Prowler Developer Guide links

© prowler-cloud · Apache-2.0 · prowler-cloud/prowler

Похожие скиллы

Все скиллы по теме «Безопасность» →
auditing-cloud-with-cis-benchmarks mahipal Скилл auditing-cloud-with-cis-benchmarks проверяет окружения AWS, Azure и GCP по стандартам CIS Benchmarks с помощью Prowler и ScoutSuite. Помогает находить уязвимости конфигурации и готовиться к аудитам. CX Codex +1 282установок cloud-security Alireza Rezvani Скилл cloud-security ищет дыры в конфигурации AWS, Azure и GCP: пути эскалации привилегий в IAM, публичные бакеты, открытые порты в security group. Пригодится перед аудитом или при разборе IaC. CX Codex +1 643установок infisical-app-connections Infisical Скилл infisical-app-connections объясняет, как связать Infisical с внешним сервисом через App Connection и какой метод авторизации брать для AWS, GCP, Azure или GitHub. CX Codex +1 257установок pulumi-overview pulumi Скилл pulumi-overview для Claude Code помогает ИИ-агентам управлять облачной инфраструктурой через Pulumi — от отдельных CLI-команд до многокомпонентных проектов. CX Codex +1 626установок setting-up-cloudwatch-observability aws Скилл setting-up-cloudwatch-observability для Claude Code помогает настроить CloudWatch Omni или подключить сервис к Application Signals. Он разбирает запрос на первичное подключение и направляет к нужным инструкциям. CX Codex +1 2 100установок cloud-devops davila7 Скилл cloud-devops для Claude Code собирает рабочий процесс для облачной инфраструктуры и DevOps. Он охватывает настройку облака, CI/CD, Kubernetes, мониторинг, безопасность и аварийное восстановление. CX Codex +1 107установок

Из того же набора13

Весь набор →
django-drf Скилл django-drf для быстрого создания REST API на Django с ViewSet'ами, сериализаторами и фильтрами по стандартам Prowler. Подключайте, когда пишете endpoints с RLS, JSON:API и OpenAPI документацией. CX Codex +1 484установок prowler-ci Скилл prowler-ci помогает разбираться с падениями проверок GitHub Actions и правилами пулл-реквестов в репозитории Prowler. CX Codex +1 ★ 15 302звёзд репо prowler-changelog Скилл prowler-changelog ведёт записи в CHANGELOG для компонентов Prowler через фрагменты changelog.d. Пригодится при подготовке PR и изменениях в UI, API, SDK или MCP Server. CX Codex +1 ★ 15 302звёзд репо prowler-docs Скилл prowler-docs для Claude Code задаёт стиль и структуру документации Prowler: голос бренда, Title Case, MDX-блоки и правила для терминов. Используется при написании гайдов и release notes. CX Codex +1 ★ 15 302звёзд репо prowler-compliance-review Скилл prowler-compliance-review проверяет пулреквесты с фреймворками комплаенса в репозитории Prowler. Находит синтаксические ошибки JSON, дубликаты ID и пропущенные проверки. CX Codex +1 ★ 15 302звёзд репо jsonapi Проверяет API-эндпоинты и ответы на соответствие JSON:API v1.1. Нужен при создании, изменении и ревью API. CX Codex +1 ★ 15 302звёзд репо prowler-compliance Скилл prowler-compliance ведёт compliance-фреймворки Prowler от создания JSON до синхронизации с каталогом-первоисточником и ревизии привязки чеков к требованиям. CX Codex +1 ★ 15 302звёзд репо prowler-test-ui Скилл prowler-test-ui задаёт правила E2E-тестирования интерфейса Prowler на Playwright. Пригодится при написании и правке тестов в каталоге ui/tests. CX Codex +1 ★ 15 302звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой