About advpl-debugging
advpl-debugging is a skill for diagnosing ADVPL/TLPP compilation and runtime issues, from error messages and locked records to slow routines and AppServer crashes. It combines symptom-based triage with guidance on logging, database locks, and performance checks.
Key features
- 01Compilation and runtime triage
- 02Symptom-based diagnosis
- 03Logging tool guidance
- 04Database lock diagnosis
- 05Performance checks
Use cases
- 01Investigating a compiler error or stack trace
- 02Diagnosing a hanging or locked record
- 03Tracing an AppServer crash through logs
- 04Checking a slow routine for common causes
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill advpl-debuggingAfter installing, type/advpl-debuggingin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
common-errors.mdperformance-tips.mdreference.mdDetails
From the project READMEADVPL/TLPP Debugging
This skill provides a systematic methodology for diagnosing and resolving ADVPL/TLPP errors: a decision flow (compilation vs. runtime), a quick-diagnosis table by symptom, logging tool guidance (Conout, FWLogMsg, ErrorBlock), database lock diagnosis (RecLock/MsUnlock), and quick performance checks (wrong index, array growth in loops, Embedded SQL vs ISAM).
Activate this skill when the user reports an error message, a stack trace, a compilation failure, a hanging/locked record, a slow routine, or an AppServer crash/log to investigate. It does not cover generating new code from scratch (see advpl-code-generation), a general quality audit of working code (see advpl-code-review), restructuring code that already works correctly (see advpl-refactoring), or converting .prw to .tlpp (see advpl-to-tlpp-migration).
| Reference file | Read when |
|---|---|
| reference.md | Always -- debug methodology flow, quick diagnosis by symptom, logging tools, lock diagnosis, performance quick checks, common debugging mistakes |
| common-errors.md | Looking up a specific compilation or runtime error message (top 50 ADVPL/TLPP errors with cause and fix) |
| performance-tips.md | Investigating a performance bottleneck in depth (query optimization, loop efficiency, memory) |