mcpField
T
tdn-lookup

tdn-lookup

github.com/thalysjuvenalDevelopment19148 installsUpdated 6w ago
Repository

About tdn-lookup

A search-strategy skill for locating official TOTVS documentation on TDN when local references are incomplete. It guides developers through a tiered fallback from cached material to API, browser, and manual site searches.

Key features

  1. 01Local cache first
  2. 02Confluence REST API search
  3. 03Playwright API fallback
  4. 04Web search and navigation
  5. 05Manual TDN search

Use cases

  1. 01Finding undocumented native functions or errors
  2. 02Looking up official TOTVS documentation
  3. 03Escalating when local references are incomplete

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill tdn-lookup

After installing, type/tdn-lookupin Claude Code to confirm it loaded.

Bundled filesreference.md

Details

From the project README

TDN Lookup — Online Search Strategy

This skill defines the standardized fallback strategy for finding official TOTVS documentation on TDN (tdn.totvs.com, a public Confluence Data Center 7.19 site with an unauthenticated REST API) whenever local reference material is insufficient. It specifies a five-tier escalation: Tier 1 always checks the relevant local cache file first (native functions, SX dictionary, common errors, entry points, business modules); Tier 2 queries the Confluence REST search API directly via WebFetch with a CQL query; Tier 3 falls back to Playwright hitting the same API when WebFetch is blocked; Tier 4 uses WebSearch plus Playwright navigation when CQL search yields nothing; Tier 5 is a last-resort manual/visual search on the TDN site itself.

Activate this skill whenever a native function, entry point, error code, or business process is not found (or only partially found) in the local reference files, or whenever the user explicitly asks for official TOTVS documentation. It does not itself contain domain knowledge -- it only orchestrates the search process; the actual native function, entry point, and error catalogs live in protheus-reference, advpl-code-generation, advpl-debugging, and protheus-business.

Reference fileRead when
reference.mdAlways -- tier-by-tier search strategy, CQL query construction, HTML/JSON parsing steps, fallback conditions per tier

Comments

Markdown supported