Agent skill

Protheus Business

by thalysjuvenal in 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…

MITAuto-check passed

Install Protheus Business

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

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

GitHub CLI
$ gh skill install thalysjuvenal/advpl-specialist protheus-business --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/protheus-business .claude/skills/protheus-business && 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
protheus-business
GitHub stars
186
Token cost
~671 tokens
SKILL.md length
257 words
Files
10
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

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…

  • The user needs to understand a TOTVS Protheus ERP business process
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Module workflow
  • Cross-module integration -- covering Compras (COM)

What it does

Protheus Business is an agent skill from thalysjuvenal/advpl-specialist. Use when the user needs to understand a TOTVS Protheus ERP business process, module workflow, or cross-module integration -- covering Compras (COM), Estoque (EST), Faturamento (FAT), Financeiro (FIN), Contabilidade (CTB), Fiscal (FIS), PCP, and Manutencao de Ativos (MNT), including their main routines (e.g. MATA110, MATA460), tables/fields, and business rules. Also triggers on Portuguese phrasing like "processo de negocio", "modulo de compras/estoque/faturamento/financeiro/fiscal/contabilidade/pcp/manutencao"…

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `modulo-compras.md`, `modulo-contabilidade.md` and `modulo-estoque.md`).

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 needs to understand a TOTVS Protheus ERP business process
  • Module workflow
  • Cross-module integration -- covering Compras (COM)
  • Faturamento (FAT)

Example prompts

  • “processo de negocio”
  • “como funciona o ciclo de compras”
  • “/protheus-business”

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

Protheus Business loads about 671 tokens when it runs. Until then it costs about 154 tokens; SKILL.md has 257 words of instructions outside code blocks.

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

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). 257 words, ~671 tokens.

Download SKILL.mdSave it as .claude/skills/protheus-business/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
protheus-business
description
Use when the user needs to understand a TOTVS Protheus ERP business process, module workflow, or cross-module integration -- covering Compras (COM), Estoque (EST), Faturamento (FAT), Financeiro (FIN), Contabilidade (CTB), Fiscal (FIS), PCP, and Manutencao de Ativos (MNT), including their main routines (e.g. MATA110, MATA460), tables/fields, and business rules. Also triggers on Portuguese phrasing like "processo de negocio", "modulo de compras/estoque/faturamento/financeiro/fiscal/contabilidade/pcp/manutencao", "como funciona o ciclo de compras", or questions about integration between modules.

Protheus Business Processes

This skill is a reference guide for TOTVS Protheus ERP business processes across eight modules: Compras, Estoque, Faturamento, Financeiro, Contabilidade, Fiscal, PCP, and Manutencao de Ativos. For each module it documents the main tables and fields, the key routines (e.g. MATA110, MATA460, MATA103), step-by-step business flows, and how the module integrates with others.

Activate this skill when the user asks how a business process works, which tables/fields a routine touches, or how two modules integrate (e.g. Compras feeding Estoque and Financeiro). Look up the module first in the local reference files; if the answer isn't found locally, fall back to a TDN web search as described in the lookup strategy.

It does not cover native function syntax (see protheus-reference), writing the SQL to query these tables (see embedded-sql), or generating/reviewing code that implements these processes (see advpl-code-generation, advpl-code-review).

Reference fileRead when
reference.mdAlways -- module index, lookup strategy (local first, then TDN), and response format per query type
modulo-compras.mdQuestions about Compras (COM): solicitacoes, cotacoes, pedidos de compra, liberacao, entrada de NF
modulo-estoque.mdQuestions about Estoque (EST): movimentacoes, saldos, armazens, inventario
modulo-faturamento.mdQuestions about Faturamento (FAT): pedidos de venda, notas fiscais de saida, faturamento
modulo-financeiro.mdQuestions about Financeiro (FIN): titulos a pagar/receber, baixas, fluxo de caixa
modulo-contabilidade.mdQuestions about Contabilidade (CTB): lancamentos contabeis, plano de contas, integracao contabil
modulo-fiscal.mdQuestions about Fiscal (FIS): apuracao de impostos, SPED, documentos fiscais
modulo-pcp.mdQuestions about PCP: ordens de producao, estrutura de produtos, MRP
modulo-manutencao.mdQuestions about Manutencao de Ativos (MNT): ordens de manutencao, ativos, planos de manutencao

© 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 9 other files in skills/protheus-business of thalysjuvenal/advpl-specialist.

  • SKILL.md
  • modulo-compras.md
  • modulo-contabilidade.md
  • modulo-estoque.md
  • modulo-faturamento.md
  • modulo-financeiro.md
  • modulo-fiscal.md
  • modulo-manutencao.md
  • modulo-pcp.md
  • reference.md

Open the folder on GitHubat commit d80599b

Compare with similar skills

Protheus Business 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.

Protheus Business compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Protheus Business this skillthalysjuvenal/advpl-specialist186—~671Automated safety check: PassMIT
Video Understandcalesthio/OpenMontage66k—~841Automated safety check: PassAGPL-3.0
Understand ExplainEgonex-AI/Understand-Anything86k—~1.3kAutomated safety check: PassMIT
Understanding by Design PlannerTHU-MAIC/OpenMAIC40k—~548Automated safety check: PassMIT
Understand Diff AnalysisEgonex-AI/Understand-Anything86k—~1.4kAutomated safety check: PassMIT
Understand Issuemastra-ai/mastra29k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    66k GitHub stars~841 tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    86k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Plans an OpenMAIC lesson or course series by backward design: enduring understandings and essential questions first, then performance evidence, then learning activities.

    40k GitHub stars~548 tokensUpdated today
    EducationAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Understand Issue

    mastra-ai/mastra

    Investigate a GitHub issue or reported bug the way a seasoned maintainer would — form an independent model before reading the thread's theories, trace the mechanism and history, verify the…

    29k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Understand PR

    mastra-ai/mastra

    Review a PR the way a seasoned maintainer would — build an independent model before seeing the diff, investigate the implementation and history, verify material claims, and return a concise briefing.

    29k GitHub stars~5.3k 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 27 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 27 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 27 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 27 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 27 days ago
    Auto-check passed
  • Protheus Reference

    thalysjuvenal/advpl-specialist

    A skill your agent uses when the user needs to look up a TOTVS Protheus native function's syntax/parameters/return value, the SX data dictionary structure (SX1-SX9, SIX), REST API endpoint patterns…

    186 GitHub stars~621 tokensUpdated 27 days ago
    Auto-check passed

Questions about Protheus Business

What does Protheus Business do?

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…. Protheus Business is an agent skill from thalysjuvenal/advpl-specialist.g.

When should I use Protheus Business?

Protheus Business fits situations like: the user needs to understand a TOTVS Protheus ERP business process; module workflow; cross-module integration -- covering Compras (COM); faturamento (FAT).

How do I install Protheus Business in Claude Code?

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

How do I install Protheus Business in Codex?

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

Can I use Protheus Business 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 protheus-business -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/protheus-business, .gemini/skills/protheus-business, .github/skills/protheus-business and .opencode/skills/protheus-business in your project.

What does Protheus Business need to run?

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

Does Protheus Business 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 Protheus Business 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 Protheus Business use?

Protheus Business 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 Protheus Business use?

About 671 tokens (SKILL.md is roughly 2.7k 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 Protheus Business?

Skills that share tags, products or a category with Protheus Business: Video Understand (calesthio/OpenMontage, 66k stars), Understand Explain (Egonex-AI/Understand-Anything, 86k stars), Understanding by Design Planner (THU-MAIC/OpenMAIC, 40k stars) and Understand Diff Analysis (Egonex-AI/Understand-Anything, 86k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Protheus Business?

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.