whatisgithub

What is engpro-advpl-tlpp-skills?

totvs/engpro-advpl-tlpp-skills — explained in plain English

Analysis updated 2026-05-18

54ShellAudience · developerComplexity · 3/5Setup · easy

In one sentence

A collection of structured skill files that teach AI coding agents how to work with TOTVS Protheus ADVPL and TLPP code.

Mindmap

mindmap
  root((repo))
    What it does
      AI agent skills
      ADVPL and TLPP guidance
      Structured SKILL files
    Tech stack
      ADVPL
      TLPP
      YAML
      Shell
    Use cases
      Generate MVC screens
      Write documentation
      Review legacy code
      Migrate old code
    Audience
      Protheus developers
      AI agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate MVC screens and REST API endpoints for TOTVS Protheus using an AI agent.

USE CASE 2

Have an AI agent write ProtheusDOC-style documentation for ADVPL code.

USE CASE 3

Review legacy ADVPL code for known quality problems before migrating it.

USE CASE 4

Install skills at the project level so an agent applies them only to one codebase.

What is it built with?

ADVPLTLPPYAMLShell

How does it compare?

totvs/engpro-advpl-tlpp-skillsnelsonwerd/idea-to-ship-skillszhihumomo/bashagt
Stars545454
LanguageShellShellShell
Setup difficultyeasymoderateeasy
Complexity3/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
The README does not state a license.

So what is it?

EngPro AI Agent Skills is a repository maintained by TOTVS, a Brazilian enterprise software company, providing structured instructions for AI coding agents that work with ADVPL and TLPP. ADVPL is the programming language used to customize TOTVS Protheus, an ERP system widely used in Brazil and Latin America for finance, HR, and business operations. TLPP is a newer companion language in the same ecosystem. The README is written primarily in Portuguese. In this project, a skill is a folder containing a SKILL.md file with structured guidance that tells an AI coding agent how to perform a specific development task consistently and correctly. The README describes a three-level design: a small YAML header that is always loaded in the agent's context, a full instruction body that loads when the agent determines the skill is relevant, and supplementary files such as templates or reference examples that the agent reads only as needed. This approach is intended to keep token usage low while still providing detailed guidance at the moment it matters. The repository includes 20 skills for ADVPL/TLPP development covering tasks such as generating MVC screens, creating REST API endpoints, writing ProtheusDOC-style code documentation, reviewing code for known quality problems, migrating legacy code, and optimizing SQL queries. A second collection of 14 general-purpose skills called Superpowers provides agent behaviors applicable across any project. Skills can be installed at the user level to apply to all projects, or at the project level to apply only to a specific codebase. Supported AI agents include Claude Code, Cursor, GitHub Copilot, Cline, Windsurf, and more than a dozen others. The repository also includes CLAUDE.md and AGENTS.md files containing background knowledge about the Protheus ecosystem that agents read before starting work. TOTVS states in the README that human review of AI-generated code remains necessary, and that AI systems can produce errors.

Copy-paste prompts

Prompt 1
Explain what a skill is in this repo and how its three-level loading design works.
Prompt 2
What ADVPL and TLPP development tasks do the 20 skills in this repo cover?
Prompt 3
How do I install one of these skills for use with Claude Code or Cursor?
Prompt 4
What do the CLAUDE.md and AGENTS.md files in this repo provide to an AI agent?

Frequently asked questions

What is engpro-advpl-tlpp-skills?

A collection of structured skill files that teach AI coding agents how to work with TOTVS Protheus ADVPL and TLPP code.

What language is engpro-advpl-tlpp-skills written in?

Mainly Shell. The stack also includes ADVPL, TLPP, YAML.

What license does engpro-advpl-tlpp-skills use?

The README does not state a license.

How hard is engpro-advpl-tlpp-skills to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is engpro-advpl-tlpp-skills for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.