TOTVS ADVPL TLPP Skills
Twenty TOTVS skills for Protheus ERP: MVC generation, AdvPL to TLPP migration, review, SQL and TIR tests, CLAUDE.md and AGENTS.md
- 171 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skills give the agent instructions for generating and editing Protheus code, while you verify execution and compilation
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/totvs-advpl-tlpp-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skills give the agent instructions for generating and editing Protheus code, while you verify execution and compilation
This is third-party code. Review the repository files before installing.
What it does
TOTVS Protheus Engineering published skill sets on the open Agent Skills standard. The `advpl-tlpp` collection holds twenty skills for developing in AdvPL and TLPP on Protheus ERP, and the `superpowers` collection adds fourteen general agent skills. Applied skills include `mvc-generator`, `fwrest-client-generator`, `fwmsexcelxlsx-generator`, `entry-point-designer`, `query-builder`, `tir-test-generator`, `advpl-to-tlpp-migration`, `refactor`, `code-review`, `sql-optimization`, `sql-code-review`, `data-dictionary-lookup`, `advpl-tlpp-compile` and `documentation-writer`. The skills use progressive disclosure: the header is always in the agent context, the `SKILL.md` body loads when needed and the `references/` notes open on demand, which saves tokens. The `advpl-tlpp-sdd` skill drives spec-driven development step by step: discuss, specify, design, tasks, implement, validate. A `CLAUDE.md` and an `AGENTS.md` with identical content are provided separately: language and ecosystem, project layout, naming and Hungarian notation conventions, mandatory practices such as soft delete and branch filtering, the MVC pattern, modern TLPP, RDMake builds and TIR tests. You copy one of the two files into the project root.
Who it is for. Developers customizing TOTVS Protheus ERP in AdvPL and TLPP who work with Claude Code, Cursor or Copilot.
Good fit when
- Protheus data models need MVC forms with `MenuDef`, `ModelDef` and `ViewDef`, and `mvc-generator` prepares the skeleton
- Old AdvPL code is moved to TLPP with namespaces and annotations through `advpl-to-tlpp-migration`
- Protheus database queries are checked with `sql-code-review` and `sql-optimization`
- Tests for new functions come from `tir-test-generator` on the TIR framework
- The project root gets `CLAUDE.md` or `AGENTS.md` so the agent knows Protheus conventions from the first message
Not a fit when
- The project is not on Protheus: the skills are tied to AdvPL, TLPP and TOTVS frameworks
- You want release-ready code with no human review: TOTVS itself warns that AI can make mistakes
- You want a general dev method with no ERP tie: the `superpowers` collection alone fits better than the applied skills
Example request
Create a customer reference form with ModelDef and ViewDef using the mvc-generator skill and show the code-review skill checkLimitations
The README and skill texts are in Portuguese. Skills are placed in the agent directory by hand: `~/.claude/skills`, `~/.agents/skills` and `~/.copilot/skills` for personal use, `.claude/skills`, `.github/skills` and `.agents/skills` for projects. Version packages are published on the releases page. The `CLAUDE.md` and `AGENTS.md` files are equivalent and only one should be used. Compilation through `advpl-tlpp-compile` relies on the TDS extension for VS Code, and generated code needs human review and a Protheus test environment.
How to disable. Delete the skill folders from the agent directory and `CLAUDE.md` or `AGENTS.md` from the project root.
FAQ
How do I install the TOTVS AdvPL skills in Claude Code?
Download the package from the releases page and put the skill folders in the project `.claude/skills` or in `~/.claude/skills`. Copy `instructions/CLAUDE.md` into the project root.
Which agents are supported?
Claude Code, Cursor, GitHub Copilot, Windsurf and Cline, plus Aider, Gemini CLI, OpenAI Codex, Roo Code, OpenCode, Amazon Q and others that read skills under the open standard.
How do CLAUDE.md and AGENTS.md differ?
Only by name: the content is identical. Claude Code reads `CLAUDE.md`, while Copilot, Cursor, Windsurf, Cline and others read `AGENTS.md`. Copy one file.
What does the advpl-tlpp-sdd skill do?
It drives spec-driven development: discuss, specify, design, tasks, implement and validate. Each step has a note in `references/`, and `state-management` and `session-handoff` describe state and session handoff.
Can I take only some of the skills?
Yes. Each folder stands on its own, so copy just what you need, for example `query-builder` and `sql-code-review`. The notes sit inside the skill folders.
Discussion
No questions or reviews yet.
Related
SkillsClaude Code plugin for ADVPL and TLPP development on TOTVS Protheus ERP: 15 commands, 10 agents, review, migration and tests
Two skills for Codex and Claude Code: prd keeps a living implementation checklist and review audits designs from the user's side
A skills library for Claude Code, Cursor and Codex: team code review, TDD, stacked PRs and repository readiness scoring
PRP (Product Requirement Prompts)
PRPs-agentic-eng
This skill set assembles a Product Requirement Prompt: the goal, file paths, code examples and validation commands for an agent.
Nine personal engineering skills: an idea-to-PR chain, standards search, a sandboxed review loop and wizard pages for changes
15 skills for Claude Code and Codex: Laravel, Docker, UI, debugging, tests and docs in four ready plugin bundles
README in short
The README explains what Agent Skills are and how progressive disclosure works, lists supported agents and the two collections, then shows directory paths for personal and project skills. A separate section covers `CLAUDE.md` and `AGENTS.md` with a table of their sections. Custom agents, contribution and security follow.