advpr-test-automation

Name: advpr-test-automation
Author: thalysjuvenal

github.com/thalysjuvenalTesting & quality19148 installsUpdated 6w ago

About advpr-test-automation

A guidance skill for writing and running ADVPR regression tests of TOTVS Protheus business rules. It helps developers choose routine-specific test patterns, organize TestSuites, and prepare code for headless runs.

Key features

01FWTestHelper assertions
02TestSuite organization
03UI and headless execution
04Patterns for routine types
05Headless routine preparation

Use cases

01Creating or debugging ADVPR scripts
02Setting up a TestSuite
03Diagnosing headless TimeOut failures

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill advpr-test-automation

After installing, type/advpr-test-automationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

api-fwtesthelper.md

best-practices.md

gps-de-testes.md

patterns-execauto.md

patterns-mvc.md

patterns-processing.md

patterns-reports.md

patterns-routine-prep.md

patterns-smartlink.md

patterns-smartview.md

patterns-totvs-message.md

patterns-webservice.md

reference.md

Details

From the project README

ADVPR — Automação de Testes Protheus

This skill covers writing and running automated business-rule regression tests for TOTVS Protheus using ADVPR, the internal ADVPL-based test robot. It explains the FWTestHelper assertion API, how to register and organize test cases in a TestSuite (GPS de Testes), how to run suites with or without UI (FWMyTestRunner vs headless FwExecSuite), and per-routine-pattern scripting guidance for MVC, ExecAuto/MSExecAuto, reports, processing routines, webservices (REST/SOAP/Portal), SmartLink, Smart View, and TOTVS Message (single-message) flows. It also covers "routine preparation" -- adjusting legacy code so it runs screen-free during official headless execution -- and general ADVPR scripting best practices.

Activate this skill when the user wants to create or debug an ADVPR test script, set up a TestSuite, diagnose a TimeOut or unexpected-screen failure during headless execution, or needs guidance on which ADVPR pattern applies to a given routine type. It does not cover manual/interface-driven QA, unit testing of isolated ADVPL functions outside ADVPR, or general debugging of runtime/compilation errors unrelated to test automation (see advpl-debugging).

The referenced files are written in Brazilian Portuguese.

Reference file	Read when
reference.md	Always -- ADVPR concept, patch prerequisite, FWMyTestRunner vs FwExecSuite headless execution, TimeOut causes
api-fwtesthelper.md	Writing assertions/expectations -- full FWTestHelper method reference
best-practices.md	Reviewing or writing ADVPR scripts -- recommended scripting conventions
gps-de-testes.md	Creating/organizing a TestSuite and its test cases (GPS de Testes)
patterns-execauto.md	Automating routines exposed via ExecAuto/MSExecAuto
patterns-mvc.md	Automating MVC (ModelDef/ViewDef) routines
patterns-processing.md	Automating batch/processing routines
patterns-reports.md	Automating reports (TOTVS Report, R3, FWMSPrinter, Smart View)
patterns-routine-prep.md	Adjusting a routine to bypass screens/alerts for official headless execution
patterns-smartlink.md	Automating routines that integrate via SmartLink
patterns-smartview.md	Automating Smart View-based routines (to build a Smart View business object rather than test one, see `smartview-development`)
patterns-totvs-message.md	Automating routines that use the single-message (TOTVS Message) pattern
patterns-webservice.md	Automating REST, SOAP, or Portal Protheus webservice endpoints

Comments

Markdown supported

Details

Author: thalysjuvenal
Repository: thalysjuvenal/advpl-specialist
Category: Testing & quality
Installs: 48
GitHub stars: 191

Report

More skills

All skills

hyperframes-cli

github.com/heygen-com

1.3M

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, compare, grade-compare, preview, play, render, publish, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (hyperframes lambda deploy / render / progress / destroy / policies / sites).

tdd

github.com/mattpocock

1.2M

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

anti-ui-slop

uizze.com

932.8k

Stop coding agents from shipping generic UI. Use UIZZE's 800,000+ real web and iOS screens to build product-specific interfaces, define a design contract, cover required states, and run a hard finish gate. Use when designing, implementing, redesigning, critiquing, or pre-ship reviewing a web or iOS interface in Codex, Claude Code, Cursor, Copilot, or another coding agent. Trigger with "anti-ui-slop", "stop UI slop", "ground this UI in real screens", or "run the UI finish gate".

diagnosing-bugs

github.com/mattpocock

856.9k

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.