Agent skill

Smartx Development

by thalysjuvenal in thalysjuvenal/advpl-specialist

A skill your agent uses when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary…

MITAuto-check passed

Install Smartx Development

skills CLI
$ npx skills add thalysjuvenal/advpl-specialist --skill smartx-development -a claude-code

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

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

At a glance

A skill your agent uses when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary…

  • The user wants to build
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Portuguese phrasing like tela Smart X
  • Gerar tela por metadados

What it does

Smartx Development is an agent skill from thalysjuvenal/advpl-specialist. Use when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary Object/Model/Interface/Launcher chain. Covers the model.tlpp/interface.tlpp/launcher artifacts, ADVPL function integration via pageActions/tableActions/onChange, converting a legacy MVC browse to Smart X, and common troubleshooting. Also triggers on Portuguese phrasing like "tela Smart X", "gerar tela por metadados", "migrar MVC para Smart…

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `patterns-advpl-integration.md`, `patterns-interface.md` and `patterns-launcher-browse.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 wants to build
  • Portuguese phrasing like tela Smart X
  • Gerar tela por metadados
  • Migrar MVC para Smart X

Example prompts

  • “tela Smart X”
  • “gerar tela por metadados”
  • “migrar MVC para Smart X”
  • “/smartx-development”

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

Smartx Development loads about 742 tokens when it runs. Until then it costs about 158 tokens; SKILL.md has 287 words of instructions outside code blocks.

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

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). 287 words, ~742 tokens.

Download SKILL.mdSave it as .claude/skills/smartx-development/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
smartx-development
description
Use when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary Object/Model/Interface/Launcher chain. Covers the model.tlpp/interface.tlpp/launcher artifacts, ADVPL function integration via pageActions/tableActions/onChange, converting a legacy MVC browse to Smart X, and common troubleshooting. Also triggers on Portuguese phrasing like "tela Smart X", "gerar tela por metadados", "migrar MVC para Smart X", "criar Modelo e Interface Smart X", "launcher Smart X", or names like FINA050SM/MATA110SX.

Smart X

This skill covers developing TOTVS Smart X routines: the Object -> Model -> Interface -> Launcher chain that turns a data dictionary table (SX2/SX3) into an automatically-rendered PO-UI screen without hand-written Angular components. It documents the required includes and annotations for the Model (totvs.framework.structure.model.th) and Interface (totvs.framework.structure.Interface.th) TLPP classes, the Launcher function that registers the routine in the Protheus menu, integrating existing ADVPL functions into the interface via pageActions/tableActions/events, and converting only the browse (Data View) of a legacy MVC routine to Smart X while keeping ModelDef/ViewDef/MenuDef intact.

Activate this skill when the user is creating a new Smart X routine from scratch, wiring an ADVPL function call into a Smart X page/table action, converting a legacy MVC browse to a Smart X browse, or debugging a Smart X screen/model/interface issue. It does not cover classic MVC routine development without Smart X (see advpl-code-generation, file patterns-mvc.md), nor data dictionary configuration scripts for SX2/SX3 themselves (see sx-configuration). It is also unrelated to Smart View, the TReports analytics tool whose custom business objects are covered by smartview-development -- the names are similar, the frameworks are not.

The referenced files are written in Brazilian Portuguese.

Reference fileRead when
reference.mdAlways -- Smart X concept, Object/Model/Interface/Launcher architecture, includes/annotations, minimal end-to-end example
patterns-model.mdWriting or reviewing the Model (model.tlpp) class and its data/business-rule definitions
patterns-interface.mdWriting or reviewing the Interface (interface.tlpp) class and its UI contract (browse/forms)
patterns-launcher-browse.mdConverting only the browse (Data View) of an existing MVC routine to Smart X rendering
patterns-advpl-integration.mdCalling existing ADVPL functions from Smart X via pageActions, tableActions, or events like onChange
patterns-migration.mdMigrating a full legacy routine to a 100% Smart X implementation
troubleshooting.mdDiagnosing errors or unexpected behavior in a Smart X screen, Model, or Interface

© 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 7 other files in skills/smartx-development of thalysjuvenal/advpl-specialist.

  • SKILL.md
  • patterns-advpl-integration.md
  • patterns-interface.md
  • patterns-launcher-browse.md
  • patterns-migration.md
  • patterns-model.md
  • reference.md
  • troubleshooting.md

Open the folder on GitHubat commit d80599b

Compare with similar skills

Smartx Development 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.

Smartx Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Smartx Development this skillthalysjuvenal/advpl-specialist186—~742Automated safety check: PassMIT
Reversible MigrationJuliusBrussee/caveman111k1 repos~196Automated safety check: PassApache-2.0
Database Migrationsaffaan-m/ECC276k4 repos~3kAutomated safety check: PassMIT
Database Migrationsaffaan-m/ECC276k1 repos~2.4kAutomated safety check: PassMIT
Safe Database Migration Patternsaffaan-m/ECC276k—~3.3kAutomated safety check: PassMIT
Migrate Createruvnet/ruflo74k—~583Automated safety check: NotesMIT

Similar skills

  • Reversible Migration

    JuliusBrussee/caveman

    Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and…

    111k GitHub starsUsed in 1 repo~196 tokens
    DevelopmentAuto-check passed
  • Safe, reversible database migration patterns: forward-only production changes, expand-contract zero-downtime renames, concurrent indexes, batched backfills, and per-tool workflows for PostgreSQL…

    276k GitHub starsUsed in 4 repos~3k tokens
    DatabasesAuto-check passed
  • Şema değişiklikleri, veri migration'ları, rollback'ler ve PostgreSQL, MySQL ve yaygın ORM'ler (Prisma, Drizzle, Django, TypeORM, golang-migrate) arasında sıfır kesinti deployment'ları için…

    276k GitHub starsUsed in 1 repo~2.4k tokens
    DatabasesAuto-check passed
  • Rules and examples for safe, reversible schema changes in production: zero-downtime column and index changes, large data backfills and ORM migration workflows.

    276k GitHub stars~3.3k tokensUpdated 4 days ago
    DatabasesAuto-check passed
  • Migrate Create

    ruvnet/ruflo

    Create a new sequentially numbered database migration with up/down SQL files

    74k GitHub stars~583 tokensUpdated today
    DatabasesAuto-check: notes
  • Migration

    kortix-ai/suna

    How to change the database schema in this repo. An agent skill from kortix-ai/suna.

    20k GitHub stars~1.2k tokensUpdated today
    DatabasesAuto-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 25 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 25 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 25 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 25 days ago
    Auto-check passed
  • Protheus Business

    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…

    186 GitHub stars~671 tokensUpdated 25 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 25 days ago
    Auto-check passed

Questions about Smartx Development

What does Smartx Development do?

A skill your agent uses when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary…. Smartx Development is an agent skill from thalysjuvenal/advpl-specialist. Use when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary Object/Model/Interface/Launcher chain.

When should I use Smartx Development?

Smartx Development fits situations like: the user wants to build; portuguese phrasing like tela Smart X; gerar tela por metadados; migrar MVC para Smart X.

How do I install Smartx Development in Claude Code?

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

How do I install Smartx Development in Codex?

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

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

What does Smartx Development need to run?

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

Does Smartx Development 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 Smartx Development 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 Smartx Development use?

Smartx Development 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 Smartx Development use?

About 742 tokens (SKILL.md is roughly 3k 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 Smartx Development?

Skills that share tags, products or a category with Smartx Development: Reversible Migration (JuliusBrussee/caveman, 111k stars), Database Migrations (affaan-m/ECC, 276k stars), Database Migrations (affaan-m/ECC, 276k stars) and Safe Database Migration Patterns (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Smartx Development?

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.