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

log-reader — скилл для Claude Code: что делает и как установить

Скилл log-reader читает логи MetaTrader 5 и вызовы Print() напрямую из файлов UTF-16LE без ручной проверки вкладки Experts в терминале.

MIT 145 установок ★ 3 обновлён 2026-10-25

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

Что делает log-reader

Скилл находит суточный журнал терминала по пути $MQL5_ROOT/Program Files/MetaTrader 5/MQL5/Logs/YYYYMMDD.log и читает записи индикаторов, скриптов или советников. Для работы используются только встроенные инструменты Read, Bash и Grep. Кодировка UTF-16LE обрабатывается инструментом чтения штатно, поэтому вывод функции Print() разбирается сразу после вызова.

Внутри настроены шаблоны поиска для фильтрации результатов: статус прогона тестов вроде Test_PatternDetector, ошибки инициализации OnInit, сбои графических стрелок и предупреждения компиляции. Скилл закрывает человекочитаемую часть схемы двойного логирования MT5, оставляя аудит структурированных данных отдельным CSV-файлам.

Без заданной переменной окружения MQL5_ROOT построить правильный путь к журналу не выйдет. Пути к файлам обязательно берутся в кавычки из-за пробелов в стандартной директории Windows.

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

  • разобрать ошибки компиляции и сбои индикаторов MT5
  • проверить результаты прогона юнит-тестов советников
  • отследить сообщения Print() без открытия вкладки Experts
  • извлечь свежие логи выполнения за текущий день

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

  • Проверь сегодняшние логи MT5 на ошибки выполнения индикатора
  • Посмотри в логах MetaTrader 5, прошли ли юнит-тесты PatternDetector
  • Выведи последние 50 строк из текущего журнала MT5

Как установить log-reader

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill log-reader -a claude-code

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

~/.claude/skills/log-reader/SKILL.md

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

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

Вопросы о log-reader

Как установить log-reader в Claude Code?

Выполните команду npx skills add terrylica/cc-skills --skill log-reader -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/log-reader/SKILL.md.

Что делает скилл log-reader?

Он автоматически собирает путь к логу MetaTrader 5 за текущую дату, парсит UTF-16LE файл и фильтрует вывод по ключевым словам через Grep или tail.

Что нужно подготовить перед запуском скилла?

В системе должна быть задана переменная окружения MQL5_ROOT, указывающая на корневой каталог данных MT5. Сам терминал должен быть запущен, чтобы файл лога за текущий день существовал.

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

SKILL.md · MIT
---
name: log-reader
description: Read MetaTrader 5 log files. TRIGGERS - MT5 logs, Experts pane, indicator errors, compilation errors.
allowed-tools: Read, Bash, Grep
---

# MT5 Log Reader

Read MetaTrader 5 log files directly to access Print() output from indicators, scripts, and expert advisors without requiring manual Experts pane inspection.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Purpose

Implement "Option 3" dual logging pattern:

- **Print()** - MT5 log files (human-readable via Experts pane)
- **CSV files** - Structured data (programmatic analysis)

Claude Code can autonomously read both outputs without user intervention.

## When to Use This Skill

Use this skill when:

- Validating MT5 indicator/script execution
- Checking compilation or runtime errors
- Analyzing Print() debug output
- Verifying unit test results (Test_PatternDetector, Test_ArrowManager)
- User mentions checking "Experts pane" manually

## Log File Location

MT5 logs are stored at:

```
$MQL5_ROOT/Program Files/MetaTrader 5/MQL5/Logs/YYYYMMDD.log
```

**File Format**:

- Encoding: UTF-16LE (Little Endian)
- Structure: Tab-separated fields (timestamp, source, message)
- Size: Grows throughout day (typically 10-100KB)

## Instructions

### 1. Construct today's log path

```bash
/usr/bin/env bash << 'SKILL_SCRIPT_EOF'
# Determine current date
TODAY=$(date +"%Y%m%d")

# Build absolute path
LOG_FILE="$MQL5_ROOT/Program Files/MetaTrader 5/MQL5/Logs/${TODAY}.log"
SKILL_SCRIPT_EOF
```

### 2. Read the entire log file

Use Read tool:

- File path: Absolute path from step 1
- The file contains all Print() statements from MT5 indicators/scripts
- UTF-16LE encoding is automatically handled by Read tool

### 3. Search for specific content (optional)

Use Grep to filter entries:

```
Pattern: indicator name, "error", "test.*passed", etc.
Path: Log file path from step 1
Output mode: "content" with -n (line numbers)
Context: -A 5 for 5 lines after matches
```

### 4. Analyze recent entries (optional)

Use Bash with tail for latest output:

```bash
tail -n 50 "$LOG_FILE"
```

## Common Validation Patterns

### Check unit test results

Search for test pass/fail indicators:

```
Pattern: test.*passed|test.*failed|Tests Passed|Tests Failed|ALL TESTS PASSED
Output mode: content
Context: -B 2 -A 2
```

### Find compilation errors

```
Pattern: error|ERROR|warning|WARNING|failed to create
Output mode: content
Context: -A 3
```

### Monitor specific indicator

```
Pattern: CCI Rising Test|PatternDetector|ArrowManager
Output mode: content
Context: -A 2
```

### View initialization messages

```
Pattern: OnInit|initialization|Initialization complete|Phase \d+
Output mode: content
```

## Examples

### Example 1: Validate unit test completion

```
Input: User compiled Test_PatternDetector.mq5
Action:
  1. Read today's log file
  2. Grep for "Test.*PatternDetector|Tests Passed|Tests Failed"
  3. Report results (e.g., "17 tests passed, 0 failed")
Output: Test status without user checking Experts pane
```

### Example 2: Check for runtime errors

```
Input: User reports indicator not working
Action:
  1. Read today's log file
  2. Grep for "ERROR|error|failed" with -A 3 context
  3. Analyze error messages
Output: Specific error details and line numbers
```

### Example 3: Verify Phase 2 arrow creation

```
Input: User asks "did the test arrow get created?"
Action:
  1. Read today's log file
  2. Grep for "Phase 2|Test arrow created|Failed to create"
  3. Check for success/failure messages
Output: Arrow creation status with timestamp
```

## Security Considerations

- Log files may contain sensitive trading data (symbol names, account info)
- Restricted to Read, Bash, Grep tools only (no network access via WebFetch)
- Do not expose absolute paths unnecessarily in user-facing output
- Filter sensitive information when reporting results
- No file modification operations allowed

## Integration with Dual Logging

This skill enables programmatic access to one half of the dual logging pattern:

1. **MT5 Log Files** (this skill) - Human-readable Print() output
2. **CSV Files** (CSVLogger.mqh) - Structured audit trails for validation

Both are accessible without user intervention:

- MT5 logs: Read via this skill
- CSV files: Read directly via Read tool or validate_export.py

## Validation Checklist

When using this skill:

- [ ] Log file exists for today's date
- [ ] File size > 0 (not empty)
- [ ] Contains expected indicator/script output
- [ ] Timestamps match execution time
- [ ] Error messages (if any) are actionable
- [ ] Test results (if applicable) show pass/fail counts

## References

- MT5 file locations: `docs/guides/MT5_FILE_LOCATIONS.md`
- Dual logging implementation: `docs/plans/cci-rising-pattern-marker.yaml` Phase 3-4
- CSVLogger library: `Program Files/MetaTrader 5/MQL5/Indicators/Custom/Development/CCINeutrality/lib/CSVLogger.mqh`

---

## Troubleshooting

| Issue                  | Cause                        | Solution                                          |
| ---------------------- | ---------------------------- | ------------------------------------------------- |
| Log file not found     | Wrong date or path           | Verify YYYYMMDD.log format and MQL5_ROOT env var  |
| Empty log file         | MT5 not running or no output | Ensure MT5 is running and Print() is being called |
| Encoding errors        | UTF-16LE not handled         | Read tool handles encoding automatically          |
| Missing test results   | Test not executed            | Compile and run test script in MT5 first          |
| Grep finds nothing     | Wrong pattern                | Use case-insensitive (-i) or broader pattern      |
| Old log data           | Log rotation                 | Each day creates new YYYYMMDD.log file            |
| Path contains spaces   | Unquoted path variable       | Quote paths: "$LOG_FILE"                          |
| Sensitive data exposed | Trading info in logs         | Filter sensitive fields when reporting to user    |


## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «Тесты и QA» →
gc-log-analyzer Jeremy Longshore Скилл для разбора логов сборщика мусора в задачах нагрузочного тестирования. Автоматически включается при упоминании gc log analyzer в запросе. CX Codex +1 1установок log-analysis akillness Скилл log-analysis для Claude Code, Codex, Cursor и других агентов: разбирает runtime-логи приложения, контейнера, браузера или CI и выделяет первую действующую ошибку. CX Codex +1 386установок dt-obs-log-semantic-mapping Dynatrace Скилл dt-obs-log-semantic-mapping сопоставляет поля аудит-логов вендора с семантическим словарём Dynatrace и проверяет готовую схему. CX Codex +1 1 700установок log-analytics opensearch-project log-analytics — скилл для Claude Code, который анализирует логи в OpenSearch через PPL и Query DSL. Он включается для поиска ошибок, закономерностей и аномалий в логах. CX Codex +1 131установок log-analyzer CuriousLearner Скилл log-analyzer разбирает файлы логов, находит всплески ошибок и строит отчёты с поиском причин сбоев. Пригодится при разборе инцидентов на сервере. CX Codex +1 1установок log-error-digest zebbern Скилл log-error-digest группирует похожие ошибки в логах и показывает частоту сбоев и их распределение по времени. Пригодится, чтобы найти повторяющиеся проблемы и часы пиковых ошибок. CX Codex +1 ★ 4 719звёзд репо

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

Весь набор →
dead-code-detector Скилл dead-code-detector ищет неиспользуемые функции, импорты и файлы в проектах на Python, TypeScript и Rust. Помогает подготовить кодовую базу к релизу и почистить зависимости. CX Codex +1 150установок plotext-financial-chart Скилл plotext-financial-chart строит текстовые финансовые графики в ASCII для Markdown-файлов через plotext. Помогает наглядно показать ценовые уровни прямо в документации на GitHub. CX Codex +1 146установок latex-setup Скилл latex-setup помогает установить и проверить LaTeX на macOS, настроить Skim и SyncTeX. Пригодится при подготовке новой машины или поиске проблем с пакетами. CX Codex +1 146установок adaptive-wfo-epoch Скилл adaptive-wfo-epoch подбирает число эпох обучения на каждом фолде walk-forward оптимизации и ранжирует кандидатов по walk-forward efficiency, а не по одному фиксированному значению. CX Codex +1 146установок adr-code-traceability Скилл adr-code-traceability для Claude Code добавляет ссылки на Architecture Decision Records в заголовки новых файлов и комментарии к нетривиальным решениям. Связывает код с архитектурным решением. CX Codex +1 144установок mlflow-python Скилл mlflow-python для Claude Code записывает параметры и метрики бэктестов в MLflow. Ищет эксперименты и получает историю метрик через Python API. CX Codex +1 139установок code-clone-assistant Скилл code-clone-assistant находит повторяющийся код через PMD CPD и Semgrep, помогает рефакторить нарушения DRY. Работает с точными дубликатами и похожими паттернами. CX Codex +1 139установок article-extractor Скилл article-extractor выгружает статьи и документацию с mql5.com для датасетов или справочников. Помогает собирать примеры кода MQL5 по ссылкам и авторам. CX Codex +1 138установок

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

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