mcpField
P
protheus-reference

protheus-reference

github.com/thalysjuvenalDevelopment19151 installsUpdated 6w ago
Repository

About protheus-reference

A lookup skill for developers working with TOTVS Protheus. It covers native functions, SX dictionaries, REST conventions, and system parameters, using local references first and a tiered TDN search when needed.

Key features

  1. 01Native function syntax and behavior
  2. 02SX data dictionary and field checks
  3. 03REST API conventions
  4. 04MV_* system parameter reference
  5. 05Local-first lookup with TDN fallback

Use cases

  1. 01Checking a native function's parameters or return value
  2. 02Validating a field against SX3
  3. 03Reviewing Protheus REST endpoint conventions
  4. 04Checking whether a function is restricted

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill protheus-reference

After installing, type/protheus-referencein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

native-functions.md
reference.md
rest-api-reference.md
restricted-functions.md
sx-dictionary.md
sx3-common-fields.md

Details

From the project README

Protheus Reference

This skill is a quick-lookup reference guide for the TOTVS Protheus ecosystem: native function syntax/parameters/return values across categories (String, Date/Time, Array, Database, Interface, Network, JsonObject, ExecAuto, etc.), the SX data dictionary (SX1 Perguntas through SXB/SIX), REST API patterns (FWRest annotations vs. legacy WsRestFul), and MV_* system parameters.

Activate this skill when the user needs to confirm how a native function works, validate a custom field against SX3, check REST endpoint conventions, or verify a function isn't on the restricted/internal-only list (checked first, always, before recommending any function). The lookup strategy is local-first (native-functions.md, sx-dictionary.md, sx3-common-fields.md, rest-api-reference.md), falling back to a tiered TDN online search (WebFetch API, then Playwright API JSON, then Playwright HTML) via the tdn-lookup skill when not found locally.

It does not cover business-process context for why a table/field is used (see protheus-business), writing the SQL to query these tables (see embedded-sql), or generating documentation that references these functions (see documentation-patterns).

Reference fileRead when
reference.mdAlways -- function category index, data dictionary overview, REST API pattern summary, and the local-first/TDN lookup strategy
native-functions.mdLooking up exact syntax, parameters, and return value of a specific native function
sx-dictionary.mdUnderstanding SX1-SX9/SIX table structure and programmatic usage of the data dictionary
sx3-common-fields.mdValidating whether a custom or standard field exists on a table before referencing it in code
restricted-functions.mdChecking whether a function/class is internal-only or blocked from compilation before recommending it
rest-api-reference.mdBuilding or documenting a REST endpoint (FWRest annotations or legacy WsRestFul)

Comments

Markdown supported