Agent skill

Entry Point Designer

by totvs in totvs/engpro-advpl-tlpp-skills

Design and document Protheus Entry Points (Pontos de Entrada).

MITAuto-check passed

Install Entry Point Designer

skills CLI
$ npx skills add totvs/engpro-advpl-tlpp-skills --skill entry-point-designer -a claude-code

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

GitHub CLI
$ gh skill install totvs/engpro-advpl-tlpp-skills entry-point-designer --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/totvs/engpro-advpl-tlpp-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/advpl-tlpp/entry-point-designer .claude/skills/entry-point-designer && 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
entry-point-designer
GitHub stars
143
Token cost
~1.2k tokens
SKILL.md length
485 words
Files
5 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Design and document Protheus Entry Points (Pontos de Entrada).

  • Works in 4 steps: Identify the Entry Point → Design the PARAMIXB Interface → Implement the Entry Point → …
  • Explicitly requests AdvPL
  • SKILL.md covers Overview, Language Priority — TLPP First, When to Use and How Entry Points Work, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Entry Point Designer is an agent skill from totvs/engpro-advpl-tlpp-skills. Design and document Protheus Entry Points (Pontos de Entrada). Always generates TLPP by default; only generates AdvPL (.prw) when the user explicitly requests AdvPL. Covers User Function signatures, PARAMIXB parameter layouts, return value specifications, and ProtheusDOC documentation. Use when user says 'create entry point', 'ponto de entrada', 'PARAMIXB', 'User Function hook', 'ponto de entrada TLPP', 'ponto de entrada ADVPL'.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/design-checklist.md`, `references/paramixb-and-returns.md` and `references/templates.md`).

The repository describes itself as: Repositório contendo skills para orientar desenvolvimento ADVPL/TLPP com agentes de IA. The licence is MIT.

When your agent uses it

  • Explicitly requests AdvPL
  • User says create entry point
  • Ponto de entrada
  • User Function hook

Example prompts

  • “create entry point”
  • “ponto de entrada”
  • “PARAMIXB”
  • “/entry-point-designer”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Identify the Entry Point
  2. Design the PARAMIXB Interface
  3. Implement the Entry Point
  4. Validate

What it can do on your machine

Read from SKILL.md and the folder at commit 3908e4e. 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

Entry Point Designer loads about 1.2k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 485 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

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 totvs/engpro-advpl-tlpp-skills at commit 3908e4e, republished under its MIT licence (© totvs). 485 words, ~1,156 tokens.

Download SKILL.mdSave it as .claude/skills/entry-point-designer/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
entry-point-designer
description
Design and document Protheus Entry Points (Pontos de Entrada). Always generates TLPP by default; only generates AdvPL (.prw) when the user explicitly requests AdvPL. Covers User Function signatures, PARAMIXB parameter layouts, return value specifications, and ProtheusDOC documentation. Use when user says 'create entry point', 'ponto de entrada', 'PARAMIXB', 'User Function hook', 'ponto de entrada TLPP', 'ponto de entrada ADVPL'.
license
MIT
metadata.domain
Protheus
metadata.maintainer
Customizações ADVPL/TLPP
metadata.author
Thalion Starforge
metadata.version
5.1.0
metadata.category
Code Generation

Protheus Entry Point Designer

Overview

Design, implement, and document Protheus Entry Points (Pontos de Entrada). Entry Points are the standard extensibility mechanism in TOTVS Protheus, allowing customization of standard ERP routines without modifying the original source code.

Language Priority — TLPP First

TLPP is the default and mandatory output language for every new Entry Point. Only generate AdvPL (.prw) when the user explicitly requests it (e.g., "em AdvPL", "como .prw", "legacy AdvPL", "sem TLPP").

  • Default: generate .tlpp with #include "tlpp-core.th", type annotations, Try-Catch, and namespaced helpers when applicable
  • Opt-in AdvPL: only when the user is explicit. If the request is ambiguous (e.g., the project still has many .prw files), confirm before falling back to AdvPL
  • Migrating an existing .prw Entry Point: prefer rewriting in TLPP unless the user requires keeping the original extension

When to Use

  • Creating a new Entry Point to customize standard Protheus behavior
  • Documenting existing Entry Points
  • Designing the PARAMIXB interface for custom Entry Points
  • Migrating legacy Entry Points to TLPP

How Entry Points Work

  1. A standard TOTVS routine (e.g., MATA010, FINA010) calls ExistBlock("PE_NAME") at predefined extension points
  2. If a User Function with the matching name exists in the RPO, it is executed
  3. The standard routine passes parameters via the PARAMIXB array (Private variable)
  4. The Entry Point returns a value that influences the standard routine's behavior

MANDATORY Rules

Function Naming — NEVER use the U_ prefix

The compiler resolves U_ automatically at runtime. Adding it manually causes the Entry Point to never be triggered.

✅ Correct❌ Wrong
User Function MT410INC()User Function U_MT410INC()
User Function A010TOK()User Function U_A010TOK()
File Naming — match the Entry Point name exactly

File name must be the Entry Point name in uppercase + language extension. No namespaces, no prefixes, no suffixes.

Entry PointAdvPLTLPP
MT410INCMT410INC.prwMT410INC.tlpp
FA080BUTFA080BUT.prwFA080BUT.tlpp

Show full SKILL.md (186 more words)Show less

Workflow

Step 1 — Identify the Entry Point
  1. Confirm the Entry Point name (e.g., MT410INC, A010TOK)
  2. Identify the standard routine and module (e.g., MATA410, SIGAFAT)
  3. Determine the trigger moment (before validation, after save, grid processing, etc.)
  4. Consult TDN to confirm PARAMIXB layout and return type
Step 2 — Design the PARAMIXB Interface

Document each parameter using the standard table format in PARAMIXB & Return Types.

Step 3 — Implement the Entry Point

Default: use the TLPP Template.

Only use the AdvPL Template when the user explicitly requested AdvPL.

Key implementation rules:

  • Document the Entry Point with a /*/{Protheus.doc} block (@type user function, @param, @return, @obs)
  • Always validate PARAMIXB existence (Type("PARAMIXB") == "A") and length defensively
  • Extract business logic to Static Function helpers
  • Use Try-Catch for error handling — never ErrorBlock
  • Default return value must be fail-safe (must not block the standard routine)
Step 4 — Validate

Apply the Entry Point Design Checklist before delivering.


Quick Reference

ResourceContents
TemplatesAdvPL and TLPP code templates
PARAMIXB & Return TypesPARAMIXB layout format, return types, common EP categories
Design ChecklistInterface, defensive programming, code quality, SonarQube compliance
TroubleshootingCommon issues and fixes

© totvs, 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 4 other files (references) in skills/advpl-tlpp/entry-point-designer of totvs/engpro-advpl-tlpp-skills.

  • SKILL.md
  • references/design-checklist.md
  • references/paramixb-and-returns.md
  • references/templates.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 3908e4e

Compare with similar skills

Entry Point Designer 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.

Entry Point Designer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Entry Point Designer this skilltotvs/engpro-advpl-tlpp-skills143—~1.2kAutomated safety check: PassMIT
Frontend Slideszarazhangrui/frontend-slides30k16 repos~7kAutomated safety check: PassMIT
Algorithmic Art with p5.jsanthropics/skills180k38 repos~4.9kAutomated safety check: PassApache-2.0
Canvas Designanthropics/skills180k52 repos~3kAutomated safety check: PassApache-2.0
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill134k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Frontend Slides

    zarazhangrui/frontend-slides

    Builds animated HTML slide decks that run in the browser with no dependencies, or converts PowerPoint files to the web, starting from visual style previews.

    30k GitHub starsUsed in 16 repos~7k tokens
    Documents & OfficeAuto-check passed
  • Official

    Creates original generative art in two steps: a written algorithmic philosophy, then a p5.js sketch with seeded randomness and an interactive viewer for exploring parameters.

    180k GitHub starsUsed in 38 repos~4.9k tokens
    Media & CreativeAuto-check passed
  • Canvas Design

    anthropics/skills

    Official

    Creates original posters and static art as PNG or PDF by first writing a short design philosophy, then expressing it visually on a canvas.

    180k GitHub starsUsed in 52 repos~3k tokens
    Media & CreativeAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Brand and Design Toolkit

    nextlevelbuilder/ui-ux-pro-max-skill

    Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.

    134k GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    59k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed

More from totvs/engpro-advpl-tlpp-skills

All 19 skills in this repo
  • AdvPL UTF-8 to CP1252 Converter

    totvs/engpro-advpl-tlpp-skills

    Converts AdvPL and TLPP source files from UTF-8 to Windows-1252 in place after code generation, because the Protheus compiler accepts only CP1252 files.

    143 GitHub stars~2.6k tokensUpdated 3 days ago
    Auto-check passed
  • AdvPL/TLPP Compile in VS Code

    totvs/engpro-advpl-tlpp-skills

    Compiles AdvPL and TLPP sources from VS Code with the TOTVS Developer Studio extension, handling server setup, connection and compile result reporting.

    143 GitHub stars~3.7k tokensUpdated 3 days ago
    Auto-check passed
  • Protheus Spec-Driven Development

    totvs/engpro-advpl-tlpp-skills

    Plans and builds Protheus AdvPL/TLPP features through Specify, Design, Tasks and Execute phases whose depth scales with the size of the change.

    143 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed
  • AdvPL and TLPP Code Review

    totvs/engpro-advpl-tlpp-skills

    Reviews AdvPL and TLPP source against SonarQube rules, ProtheusDOC requirements, security, performance and Protheus conventions, and reports findings by severity.

    143 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Protheus Data Dictionary Lookup

    totvs/engpro-advpl-tlpp-skills

    Queries the TOTVS Protheus ERP data dictionary for tables, fields, indexes, parameters, triggers and lookups, including impact checks during refactoring.

    143 GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Protheus MVC Generator

    totvs/engpro-advpl-tlpp-skills

    Generates Protheus MVC screens in ADVPL/TLPP, with ModelDef, ViewDef, MenuDef and Browse functions for single-entity and master-detail layouts.

    143 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

Questions about Entry Point Designer

What does Entry Point Designer do?

Design and document Protheus Entry Points (Pontos de Entrada). Entry Point Designer is an agent skill from totvs/engpro-advpl-tlpp-skills. Design and document Protheus Entry Points (Pontos de Entrada).

When should I use Entry Point Designer?

Entry Point Designer fits situations like: explicitly requests AdvPL; user says create entry point; ponto de entrada; user Function hook.

How do I install Entry Point Designer in Claude Code?

Run `npx skills add totvs/engpro-advpl-tlpp-skills --skill entry-point-designer -a claude-code`. Or copy the skill folder (skills/advpl-tlpp/entry-point-designer in totvs/engpro-advpl-tlpp-skills) into .claude/skills/entry-point-designer in your project. Claude Code loads it when a task matches its description.

How do I install Entry Point Designer in Codex?

Run `npx skills add totvs/engpro-advpl-tlpp-skills --skill entry-point-designer -a codex`. Or copy the skill folder (skills/advpl-tlpp/entry-point-designer in totvs/engpro-advpl-tlpp-skills) into .agents/skills/entry-point-designer in your project. Codex loads it when a task matches its description.

Can I use Entry Point Designer 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 totvs/engpro-advpl-tlpp-skills --skill entry-point-designer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/entry-point-designer, .gemini/skills/entry-point-designer, .github/skills/entry-point-designer and .opencode/skills/entry-point-designer in your project.

What does Entry Point Designer need to run?

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

Does Entry Point Designer 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 Entry Point Designer 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 Entry Point Designer use?

Entry Point Designer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Entry Point Designer use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Entry Point Designer?

Skills that share tags, products or a category with Entry Point Designer: Frontend Slides (zarazhangrui/frontend-slides, 30k stars), Algorithmic Art with p5.js (anthropics/skills, 180k stars), Canvas Design (anthropics/skills, 180k stars) and Impeccable (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Entry Point Designer?

totvs (a GitHub organization) maintains it in totvs/engpro-advpl-tlpp-skills, which has 143 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 5, 2026.

Source: totvs/engpro-advpl-tlpp-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.