Agent skill

Advpl Debugging

by thalysjuvenal in thalysjuvenal/advpl-specialist

A skill your agent uses when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures…

MITAuto-check passedDevelopment

Install Advpl Debugging

skills CLI
$ npx skills add thalysjuvenal/advpl-specialist --skill advpl-debugging -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thalysjuvenal/advpl-specialist advpl-debugging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thalysjuvenal/advpl-specialist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/advpl-debugging .claude/skills/advpl-debugging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
advpl-debugging
GitHub stars
186
Token cost
~487 tokens
SKILL.md length
165 words
Files
4
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures…

  • The user asks to debug
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax
  • Missing includes

What it does

Advpl Debugging is an agent skill from thalysjuvenal/advpl-specialist. Use when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures (NIL access, type mismatch, array bounds), performance issues (slow queries, memory leaks), database locks (RecLock timeouts, deadlocks), or AppServer log/crash analysis. Also triggers on Portuguese phrasing like "erro de compilacao", "erro em tempo de execucao", "travou o lock", "RecLock nao libera", "performance lenta", "analisar log do…

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `common-errors.md`, `performance-tips.md` and `reference.md`).

It sits in Development, covering Debugging, Query optimization and Performance optimization. The repository describes itself as: Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento TOTVS Protheus. The licence is MIT.

When your agent uses it

  • The user asks to debug
  • Fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax
  • Missing includes
  • Undeclared variables)

Example prompts

  • “erro de compilacao”
  • “erro em tempo de execucao”
  • “travou o lock”
  • “/advpl-debugging”

What it can do on your machine

Read from SKILL.md and the folder at commit d80599b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Advpl Debugging loads about 487 tokens when it runs. Until then it costs about 150 tokens; SKILL.md has 165 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~487

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from thalysjuvenal/advpl-specialist at commit d80599b, republished under its MIT licence (© thalysjuvenal). 165 words, ~487 tokens.

Download SKILL.mdSave it as .claude/skills/advpl-debugging/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
advpl-debugging
description
Use when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures (NIL access, type mismatch, array bounds), performance issues (slow queries, memory leaks), database locks (RecLock timeouts, deadlocks), or AppServer log/crash analysis. Also triggers on Portuguese phrasing like "erro de compilacao", "erro em tempo de execucao", "travou o lock", "RecLock nao libera", "performance lenta", "analisar log do appserver", or a pasted stack trace / error message from Protheus.

ADVPL/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 fileRead when
reference.mdAlways -- debug methodology flow, quick diagnosis by symptom, logging tools, lock diagnosis, performance quick checks, common debugging mistakes
common-errors.mdLooking up a specific compilation or runtime error message (top 50 ADVPL/TLPP errors with cause and fix)
performance-tips.mdInvestigating a performance bottleneck in depth (query optimization, loop efficiency, memory)

© thalysjuvenal, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/advpl-debugging of thalysjuvenal/advpl-specialist.

  • SKILL.md
  • common-errors.md
  • performance-tips.md
  • reference.md

Open the folder on GitHubat commit d80599b

Compare with similar skills

Advpl Debugging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Advpl Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Advpl Debugging this skillthalysjuvenal/advpl-specialist186—~487Automated safety check: PassMIT
Kernel Debugging Advancedmohitmishra786/low-level-dev-skills253—~855Automated safety check: PassMIT
Cmux Debugging Guidemanaflow-ai/cmux28k1 repos~1.1kAutomated safety check: PassCustom licence
Electron Heap Snapshot Analysiskeybase/client9.3k—~875Automated safety check: PassBSD-3-Clause
Issue Fixmono/SkiaSharp5.6k—~5.1kAutomated safety check: PassMIT
PlotJuggler 4 Perf ProfilingPlotJuggler/PlotJuggler6.2k—~1.6kAutomated safety check: NotesMPL-2.0

Similar skills

  • Kernel Debugging Advanced

    mohitmishra786/low-level-dev-skills

    Advanced kernel debugging skill for ftrace, trace-cmd, perf, kprobes, kgdb, and crash analysis.

    253 GitHub stars~855 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Cmux Debugging Guide

    manaflow-ai/cmux

    Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Analyzes V8, Chrome and Electron .heapsnapshot files with Node scripts to find memory leaks, detached DOM nodes and the retainer paths that keep objects alive.

    9.3k GitHub stars~875 tokensUpdated today
    DevelopmentAuto-check passed
  • Issue Fix

    mono/SkiaSharp

    Fix bugs in SkiaSharp C bindings. An agent skill from mono/SkiaSharp.

    5.6k GitHub stars~5.1k tokensUpdated today
    DevelopmentAuto-check passed
  • PlotJuggler 4 Perf Profiling

    PlotJuggler/PlotJuggler

    Guides CPU profiling of PlotJuggler 4 on Linux with perf: count first, record cheaply with LBR, then read per-thread, flat, flamegraph or time-window views.

    6.2k GitHub stars~1.6k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes
  • Analyzes Chrome or Electron DevTools Performance trace exports with Python scripts to find where render time actually goes, without opening DevTools.

    9.3k GitHub stars~809 tokensUpdated today
    DevelopmentAuto-check passed

More from thalysjuvenal/advpl-specialist

All 19 skills in this repo
  • Advpl Code Generation

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user asks to generate, create, or scaffold ADVPL/TLPP code for TOTVS Protheus -- User Functions, Static Functions, TLPP classes, MVC (Model/View/Controller), REST…

    186 GitHub stars~749 tokensUpdated 24 days ago
    Auto-check passed
  • Advpl Code Review

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user asks to review, audit, or check the quality of ADVPL/TLPP code for TOTVS Protheus before merge or deploy -- covering best practices (RecLock/MsUnlock pairing…

    186 GitHub stars~604 tokensUpdated 24 days ago
    Auto-check passed
  • Advpl To Tlpp Migration

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user asks to migrate, convert, compatibilize, or modernize legacy ADVPL procedural code to TLPP object-oriented classes on TOTVS Protheus -- turning User…

    186 GitHub stars~592 tokensUpdated 24 days ago
    Auto-check passed
  • Advpr Test Automation

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user wants to write, run, or troubleshoot automated regression tests for Protheus routines with ADVPR (Advanced Protheus Robot) -- covering FWTestHelper API…

    186 GitHub stars~835 tokensUpdated 24 days ago
    Auto-check passed
  • Protheus Business

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user needs to understand a TOTVS Protheus ERP business process, module workflow, or cross-module integration -- covering Compras (COM), Estoque (EST), Faturamento…

    186 GitHub stars~671 tokensUpdated 24 days ago
    Auto-check passed
  • Protheus Locks Deadlocks

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user needs to understand, diagnose, or prevent Protheus record locks and deadlocks -- covering RecLock/MsUnlock/SoftLock/LockByName semantics, BeginTran/EndTran…

    186 GitHub stars~553 tokensUpdated 24 days ago
    Auto-check passed

Categories

Questions about Advpl Debugging

What does Advpl Debugging do?

A skill your agent uses when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures…. Advpl Debugging is an agent skill from thalysjuvenal/advpl-specialist. Use when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures (NIL access, type mismatch, array bounds), performance issues (slow queries, memory leaks), database locks (RecLock timeouts, deadlocks), or AppServer log/crash analysis.

When should I use Advpl Debugging?

Advpl Debugging fits situations like: the user asks to debug; fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax; missing includes; undeclared variables).

How do I install Advpl Debugging in Claude Code?

Run `npx skills add thalysjuvenal/advpl-specialist --skill advpl-debugging -a claude-code`. Or copy the skill folder (skills/advpl-debugging in thalysjuvenal/advpl-specialist) into .claude/skills/advpl-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Advpl Debugging in Codex?

Run `npx skills add thalysjuvenal/advpl-specialist --skill advpl-debugging -a codex`. Or copy the skill folder (skills/advpl-debugging in thalysjuvenal/advpl-specialist) into .agents/skills/advpl-debugging in your project. Codex loads it when a task matches its description.

Can I use Advpl Debugging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thalysjuvenal/advpl-specialist --skill advpl-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/advpl-debugging, .gemini/skills/advpl-debugging, .github/skills/advpl-debugging and .opencode/skills/advpl-debugging in your project.

What does Advpl Debugging need to run?

SKILL.md names no scripts, command-line tools or credentials: Advpl Debugging is instructions for the agent only.

Does Advpl Debugging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Advpl Debugging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Advpl Debugging use?

Advpl Debugging is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Advpl Debugging use?

About 487 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Advpl Debugging?

Skills that share tags, products or a category with Advpl Debugging: Kernel Debugging Advanced (mohitmishra786/low-level-dev-skills, 253 stars), Cmux Debugging Guide (manaflow-ai/cmux, 28k stars), Electron Heap Snapshot Analysis (keybase/client, 9.3k stars) and Issue Fix (mono/SkiaSharp, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Advpl Debugging?

thalysjuvenal (a GitHub user) maintains it in thalysjuvenal/advpl-specialist, which has 186 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on September 14, 2026.

Source: thalysjuvenal/advpl-specialist on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.