advpl-specialist plugin
Claude Code plugin for ADVPL and TLPP development on TOTVS Protheus ERP: 15 commands, 10 agents, review, migration and tests
- 194 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- A hook recodes project files in place, and the generation commands create and edit source code.
- For documentation lookup the plugin goes online and may open a page in a browser through Playwright MCP.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/advpl-specialistDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A hook recodes project files in place, and the generation commands create and edit source code.
- For documentation lookup the plugin goes online and may open a page in a browser through Playwright MCP.
This is third-party code. Review the repository files before installing.
What it does
advpl-specialist is a Claude Code plugin that teaches the agent to write code for the TOTVS Protheus ERP in ADVPL and TLPP. The plugin brings 15 commands, 10 specialized agents and 19 reference sets on the platform. Commands are called by name, for example `/advpl-specialist:generate function FATA050 --module FAT`. For developers there is generation of functions, TLPP classes, MVC, REST APIs, reports and jobs, a port of procedural ADVPL to object-oriented TLPP, and analysis of compile, runtime and lock errors. The `review` command checks code against rules for good practice, performance and security and `test` creates ProBat unit tests. `docs` looks up functions and data dictionary tables, `refactor` suggests structural improvements, `document` writes a Protheus.doc header and `changelog` builds a change log from `git diff`. For functional consultants the `explain` command describes code in plain language and `sxgen` builds SX data dictionary scripts from a field description. A hook watches the encoding: every ADVPL file the plugin writes or edits is converted to Windows-1252, which Protheus expects.
Who it is for. Programmers and consultants who maintain and customize TOTVS Protheus, including entry points, MVC forms and REST services in ADVPL.
Good fit when
- A sales module needs a new function on a standard template, and writing the skeleton by hand takes long.
- An old procedural file `FATA001.prw` is being moved to TLPP with classes and namespaces.
- Production fails with `Variable does not exist` and you must find where in the code the variable got lost.
- A consultant inherited someone else's customization and wants it explained without reading the code.
- A new table needs SX3, SIX and SX1 dictionary scripts, but the description exists only in words.
Not a fit when
- The platform is different: the plugin knows only Protheus, ADVPL and TLPP and does not fit 1C or SAP.
- Files must not be recoded: the hook converts ADVPL files to Windows-1252 and needs `iconv`.
- Network access is closed: the references are built in, but lookup of fresh TOTVS documentation goes through WebSearch and Playwright MCP.
- You need materials in Russian: the plugin's documentation and command descriptions are written in Portuguese.
Example request
Run `/advpl-specialist:diagnose "Variable does not exist: cCodCli"` on `src/FATA050.prw` and suggest a fix.Limitations
The plugin is built for the TOTVS Protheus ecosystem and works in projects with `.prw`, `.tlpp`, `.prx` and `.ch` files. Documentation and command descriptions are in Portuguese. For fresh facts from the TDN portal the plugin goes online and falls back to Playwright MCP, which is advised to be connected separately. The recoding hook needs `iconv` in `PATH`, which macOS, Linux, WSL and Git Bash have. Characters absent from Windows-1252, such as emoji, raise a warning and the file stays in UTF-8. The last commit was made in September 2026.
How to disable. Disable the plugin through the `/plugin` menu or remove it with `/plugin uninstall advpl-specialist@thalysjuvenal-advpl-specialist`. Delete the files `AGENTS.md`, `.github/copilot-instructions.md` and the command folders copied into a project by hand.
FAQ
How do I install advpl-specialist in Claude Code?
Run `/plugin marketplace add thalysjuvenal/advpl-specialist`, then `/plugin install advpl-specialist@thalysjuvenal-advpl-specialist`. To check, open a Protheus project and call `/advpl-specialist:docs FWExecView`.
Does the plugin work in Cursor, Copilot and Gemini CLI?
Yes. `npx skills add thalysjuvenal/advpl-specialist` installs the skills. The commands live in the `.cursor/commands/`, `.github/prompts/` and `.gemini/commands/` folders, which you copy into your repository.
Which commands does the plugin have?
Fifteen: `generate`, `migrate`, `diagnose`, `docs`, `review`, `test`, `process`, `explain`, `refactor`, `document`, `changelog`, `sxgen`, `advpr`, `smartx` and `smartview`. Each is called as `/advpl-specialist:name`.
What is Playwright MCP for?
It is a fallback for documentation lookup. If WebSearch and WebFetch fail, the plugin opens the TDN page in a real browser. Connecting it is advised with `claude mcp add playwright -- npx @anthropic-ai/mcp-playwright@latest`.
Why does the plugin change file encoding?
Protheus expects Windows-1252. A hook converts every `.prw`, `.tlpp`, `.prx`, `.ch`, `.prg`, `.apw`, `.aph` and `.tlh` file that the plugin wrote or changed.
Discussion
No questions or reviews yet.
Related
PluginsTwenty TOTVS skills for Protheus ERP: MVC generation, AdvPL to TLPP migration, review, SQL and TIR tests, CLAUDE.md and AGENTS.md
A Claude Code plugin that turns on a Delphi expert mode: code style, audit, review, DUnitX tests and end-to-end app checks
GTPlanner turns a task description into a PRD and design document: planning, stack choice and design docs inside Claude Code.
A plugin that turns Claude Code into a 16 agent team: documentation first planning, TDD and 9 pre-merge quality gates.
A plugin that readies a project for Claude Code: guidance, tests, review, TDD, refactoring and a resumable fix loop
The AI-SDLC plugin for Claude Code carries a task from spec to PR: a readiness gate, a developer agent and several reviewers.
README in short
The README opens with a three-command quick start, then splits capabilities between developers and functional consultants. Next come installation, setup for Copilot, Cursor and Gemini, tables of commands and agents and the project layout.