Document start/finalize two-step import handoff in skills

[rsuresh-retool]

Summary

Documents the two-step import handoff in both retool-import skills. The handoff now prefers retool_start_prepared_import (provisions the sandbox, returns a time-limited upload URL) + a zip PUT + retool_finalize_prepared_import, and falls back to the inline retool_submit_prepared_import tool only when a step of the two-step flow errors.

Touches:

• plugins/retool-import/skills/retool-import/SKILL.md (generic)
• plugins/retool-import/skills/retool-import-lovable/SKILL.md (Lovable sibling)

Why

The product side split the MCP import into a start/finalize flow: retool_start_prepared_import returns an upload URL the client PUTs a zip to (gated on Vite readiness), then retool_finalize_prepared_import confirms it. Inlining the whole source tree into a single retool_submit_prepared_import call doesn't scale, so the two-step flow is now the preferred path. The inline submit stays as the recovery path so the skills keep working against orgs that only have the older tool.

What changed (identical edit in both skills)

• Description / intro — handoff is now the two-step flow with inline submit as fallback.
• State machine overview — Phase 6 / step 6 line rewritten to the start → upload PUT → finalize sequence.
• Prerequisites — required MCP tools relaxed: any of the import tools gated by mcpServerRetoolImportEnabled; prefer start+finalize, use inline submit if only that is visible, stop only if none are visible.
• Cleaned-source-tree note — the Record<string, { code }> is now described as zipped+uploaded in the two-step flow, or passed inline in the fallback.
• Phase 6 / Handoff — split into "Preferred — two-step flow" (start, PUT with Authorization: Bearer <token> + Content-Type: application/zip, ~2s retry on 503, finalize) and "Fallback — inline submit (only on a two-step error)". Inline submit is explicitly NOT the first attempt.
• Hard rules — outputs and the missing-tool guard updated to cover all three import tools.

Stacked on

• Add retool-import-lovable sibling skill #3 rohansuresh/retool-import-lovable-skill (Add retool-import-lovable sibling skill)
• Add retool-import skill content #2 rohansuresh/retool-import-skill
• Add plugin marketplace scaffold #1 rohansuresh/plugin-marketplace-scaffold