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

codeql-expert — скилл для Claude Code: анализ и установка

Скилл codeql-expert помогает писать и запускать запросы CodeQL, искать уязвимости и подключать анализ к GitHub Code Scanning. Работает с несколькими языками.

Apache-2.0 174 установок ★ 45 обновлён 2026-10-12

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

Что делает codeql-expert

codeql-expert даёт инструкции для статического анализа через CodeQL: создание базы из исходников, написание QL-запросов, запуск проверки и разбор результатов. С его помощью можно искать SQL-инъекции, XSS, жёстко заданные учётные данные и опасные потоки данных. Поддерживаются C/C++, C#, Go, Java, JavaScript/TypeScript, Python и Ruby.

Внутри есть примеры запросов, пользовательского taint tracking, анализа базы и преобразования результатов из BQRS в CSV. Скилл также описывает запуск стандартных наборов запросов и подключение CodeQL к GitHub Actions. Для Java нужен шаг сборки mvn clean package, поэтому без него создание базы не пройдёт.

Используйте его в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI или OpenCode. Доступ к инструментам ограничен чтением, записью, редактированием и командами codeql и gh.

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

  • создать базу CodeQL для проекта
  • написать запрос для поиска SQL-инъекций
  • найти XSS и жёстко заданные секреты
  • настроить taint tracking для пользовательского ввода
  • подключить анализ к GitHub Actions

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

  • Создай базу CodeQL для JavaScript-проекта и запусти проверку безопасности.
  • Напиши запрос CodeQL, который найдёт SQL-инъекции и покажет путь от пользовательского ввода.
  • Настрой анализ базы my-db, сохрани результаты в results.sarif и объясни найденные проблемы.

Как установить codeql-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill codeql-expert -a claude-code

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

~/.claude/skills/codeql-expert/SKILL.md

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

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

Вопросы о codeql-expert

Как установить codeql-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill codeql-expert -a claude-code. Затем используйте скилл из ~/.claude/skills/codeql-expert/SKILL.md.

Что делает codeql-expert?

Скилл помогает создавать базы CodeQL, писать QL-запросы и запускать статический анализ. Он охватывает поиск уязвимостей, taint tracking и интеграцию с GitHub Code Scanning.

Какие языки поддерживает codeql-expert?

В описании перечислены C/C++, C#, Go, Java, JavaScript/TypeScript, Python и Ruby. Для Java создание базы выполняется вместе с командой сборки mvn clean package.

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

SKILL.md · Apache-2.0
---
name: codeql-expert
version: 1.1.0
description: >-
  Expert-level CodeQL for static analysis, vulnerability detection, and security code
  scanning. Use when the user mentions static analysis, SAST, vulnerability detection, or
  github security, or when the task involves writing CodeQL queries, building a CodeQL
  database, taint tracking, or scanning for injection and hardcoded credentials.
category: security
tags: [codeql, static-analysis, sast, vulnerability-detection, github-security]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(codeql:*, gh:*)
---

# CodeQL Expert

Expert guidance for CodeQL static analysis, custom query development, vulnerability detection, and integration with CI/CD pipelines.

## Core Concepts

### CodeQL Overview

- Semantic code analysis engine
- Treats code as data (queryable database)
- Supports C/C++, C#, Go, Java, JavaScript/TypeScript, Python, Ruby
- Powers GitHub Code Scanning
- Custom query development with QL language

### CodeQL Workflow

1. Extract code to database
2. Write QL queries
3. Run analysis
4. Review results
5. Fix vulnerabilities
6. Integrate into CI/CD

### Query Types

- Security queries (vulnerabilities)
- Code quality queries (bugs, code smells)
- Compliance queries (coding standards)
- Custom queries (org-specific patterns)

## Installation & Setup

```bash
# Download CodeQL CLI
wget https://github.com/github/codeql-cli-binaries/releases/latest/download/codeql-linux64.zip
unzip codeql-linux64.zip
export PATH="$PATH:/path/to/codeql"

# Clone CodeQL queries
git clone https://github.com/github/codeql.git codeql-repo

# Verify
codeql --version
```

### Create Database

```bash
# JavaScript/TypeScript
codeql database create my-js-db --language=javascript

# Java (requires build)
codeql database create my-java-db \
  --language=java \
  --command="mvn clean package"

# Python
codeql database create my-python-db --language=python

# Multiple languages
codeql database create my-db --db-cluster --language=javascript,python
```

## Writing CodeQL Queries

### Basic Query Structure

```ql
/**
 * @name SQL Injection
 * @description Detects SQL injection vulnerabilities
 * @kind path-problem
 * @problem.severity error
 * @security-severity 9.8
 * @precision high
 * @id js/sql-injection
 * @tags security external/cwe/cwe-089
 */

import javascript
import semmle.javascript.security.dataflow.SqlInjectionQuery
import DataFlow::PathGraph

from Configuration cfg, DataFlow::PathNode source, DataFlow::PathNode sink
where cfg.hasFlowPath(source, sink)
select sink.getNode(), source, sink,
  "SQL query depends on $@.", source.getNode(), "user input"
```

### Find XSS Vulnerabilities

```ql
/**
 * @name Cross-site scripting
 * @kind path-problem
 */

import javascript
import semmle.javascript.security.dataflow.DomBasedXssQuery
import DataFlow::PathGraph

from Configuration cfg, DataFlow::PathNode source, DataFlow::PathNode sink
where cfg.hasFlowPath(source, sink)
select sink.getNode(), source, sink,
  "XSS vulnerability due to $@.", source.getNode(), "user input"
```

### Find Hardcoded Credentials

```ql
/**
 * @name Hardcoded credentials
 * @kind problem
 */

import javascript

from StringLiteral str, Variable v
where
  v.getAnAssignedExpr() = str and
  (
    v.getName().toLowerCase().matches("%password%") or
    v.getName().toLowerCase().matches("%apikey%") or
    v.getName().toLowerCase().matches("%secret%")
  ) and
  str.getValue().length() > 8 and
  not str.getValue().matches("TODO%")
select str, "Hardcoded credential: " + v.getName()
```

### Custom Taint Tracking

```ql
/**
 * @name Custom taint tracking
 */

import javascript
import semmle.javascript.dataflow.DataFlow

class CustomTaintTracking extends TaintTracking::Configuration {
  CustomTaintTracking() { this = "CustomTaintTracking" }

  override predicate isSource(DataFlow::Node source) {
    source instanceof RemoteFlowSource
  }

  override predicate isSink(DataFlow::Node sink) {
    exists(CallExpr call |
      call.getCalleeName() in ["exec", "eval", "system"]
    |
      sink.asExpr() = call.getAnArgument()
    )
  }

  override predicate isSanitizer(DataFlow::Node node) {
    node = DataFlow::BarrierGuard<StringOps::Validation>::getABarrierNode()
  }
}

from CustomTaintTracking cfg, DataFlow::PathNode source, DataFlow::PathNode sink
where cfg.hasFlowPath(source, sink)
select sink.getNode(), source, sink,
  "Dangerous operation with $@.", source.getNode(), "user input"
```

## Running CodeQL

```bash
# Analyze database
codeql database analyze my-db \
  --format=sarif-latest \
  --output=results.sarif \
  codeql/javascript-queries:codeql-suites/javascript-security-extended.qls

# Run custom query
codeql query run my-query.ql --database=my-db --output=results.bqrs

# Convert to CSV
codeql bqrs decode results.bqrs --format=csv --output=results.csv
```

### GitHub Actions Integration

```yaml
name: CodeQL Analysis

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  analyze:
    runs-on: ubuntu-latest
    permissions:
      security-events: write

    strategy:
      matrix:
        language: ['javascript', 'python']

    steps:
      - uses: actions/checkout@v4

      - name: Initialize CodeQL
        uses: github/codeql-action/init@v2
        with:
          languages: ${{ matrix.language }}
          queries: +security-extended

      - name: Autobuild
        uses: github/codeql-action/autobuild@v2

      - name: Perform CodeQL Analysis
        uses: github/codeql-action/analyze@v2
```

## Best Practices

- Start with built-in queries
- Test on small codebases first
- Optimize for performance
- Add clear documentation
- Tune to reduce false positives
- Integrate into CI/CD early

## Resources

- CodeQL Docs: https://codeql.github.com/docs/
- Queries: https://github.com/github/codeql
- Code Scanning: https://docs.github.com/en/code-security/code-scanning

© personamanagmentlayer · Apache-2.0 · personamanagmentlayer/pcl

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

Все скиллы по теме «Безопасность» →
codeql trailofbits Запускает межпроцедурный статический анализ кода и отслеживание потоков данных через CodeQL. Помогает находить уязвимости в девяти языках программирования. CX Codex +1 9 100установок sast-configuration Seth Hobson Скилл sast-configuration настраивает SAST-сканеры Semgrep, SonarQube и CodeQL и пишет для них правила безопасности. Разворачивается при внедрении сканирования кода в CI/CD. CX Codex +1 10 800установок security-scanning-security-sast sickn33 Скилл security-scanning-security-sast для Claude Code и Codex: статический анализ кода (SAST) выявляет уязвимости, захардкодированные секреты и нарушения политик безопасности во множестве языков и фреймворков. CX Codex +1 ★ 50 109звёзд репо sast-scanning devops-skills Скилл sast-scanning для Claude Code: статический анализ исходников на уязвимости до деплоя. Встраивается security-гейтом в CI/CD-пайплайн. CX Codex +1 415установок variant-analysis trailofbits Скилл variant-analysis ищет в репозитории другие проявления уже найденной ошибки. Нужен после уязвимости или логического дефекта, когда требуется проверить похожий код. CX Codex +1 7 400установок code-auditor 0xSteph Субагент code-auditor читает исходники и ищет инъекции, дыры в авторизации и зашитые секреты. Помогает отделить настоящие находки Semgrep от ложных. CX Codex ★ 2 482звёзд репо

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

Весь набор →
rust-expert Скилл rust-expert для Claude Code задаёт ИИ-агенту роль Rust-разработчика: владение, лайфтаймы, async и обработка ошибок. Разбирает неочевидные ошибки borrow checker. CX Codex +1 179установок design-expert Скилл design-expert даёт агенту паттерны системного дизайна, масштабирования и распределённых систем с готовыми примерами кода на Python. CX Codex +1 178установок airflow-expert Скилл airflow-expert для Claude Code проектирует и разбирает Apache Airflow DAG, зависимости задач, операторы, сенсоры и расписания. Помогает работать с пайплайнами данных. CX Codex +1 174установок cloudflare-expert Скилл cloudflare-expert для Claude Code помогает с Workers, CDN, периферийными вычислениями и защитой Cloudflare. Активируется в задачах про WAF, сервисы Cloudflare и их инструменты разработки. CX Codex +1 174установок skill-creator-expert Скилл skill-creator-expert помогает проектировать, писать и проверять скиллы PCL: разбирает предметную область, собирает структуру и прогоняет готовый файл по чек-листу качества. CX Codex +1 173установок django-expert Скилл django-expert помогает проектировать веб-приложения на Django: модели ORM, представления, формы, маршруты и API на Django REST Framework. CX Codex +1 172установок graphql-expert Скилл graphql-expert помогает проектировать GraphQL-схемы, писать резолверы и разбирать подписки. Пригодится при работе с Apollo Server, федерацией и проблемой N+1. CX Codex +1 169установок data-mesh-expert Скилл data-mesh-expert помогает агенту проектировать data mesh: домены владеют своими данными, дата-продукты идут с контрактами, управление федеративное, платформа самообслуживания. CX Codex +1 168установок

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

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