Convert an Existing Skill to the Agentic Orchestrator

Replace host filesystem paths

Paths such as /mnt/skills/..., /mnt/user-data/..., and /tmp/... do not exist. Text reads become declarative references; code paths become INPUT_DIR and OUTPUT_DIR.

• Before: Read /mnt/skills/public/brand/SKILL.md
• After: Read SKILL.md from the brand Skill.
• Before: pd.read_excel('/mnt/skills/user/pricing/assets/rates.xlsx')
• After: Provide assets/rates.xlsx from this Skill as a code input and open it from INPUT_DIR under the file name issued for it.

Replace host UI verbs and callbacks

view(), present_files, create_file, widget callbacks, phrases like “renders in the artifact panel”, and implicit Markdown-to-Office conversion are host features. The Agentic Orchestrator delivers files as artifacts and never converts Markdown to Office formats on its own.

• Before: “Generate structured Markdown (the host renders it as .docx).”
• After: “Generate the .docx with code execution (python-docx) and return it as an artifact.”
• Interactive buttons inside generated widgets become ordinary conversation: “offer to draft talking points next.”

Remove fixed progress announcements

Delete any requirement to open with a line such as “Account Lookup is working…”. The Agentic Orchestrator shows progress to the user itself. Remove the whole step that mandates the announcement, not just the quoted text.

Replace connector-specific tool spellings

Spellings such as Microsoft 365:get_me, WebSearch, or WebFetch are host-specific. Name the capability instead. Connectors are provisioned on the assistant through MCP Workspace, and the admin maps each capability to a server.

• Before: Call Data_Analytics:account_insights for the account.
• After: “Query account insights through the data analytics connection. If no such connection is available, tell the user which one is missing.”
• Before: Use WebFetch on the release notes page.
• After: “Fetch the release notes page from the web.”

Remove direct model and API access

Delete SDK calls, model IDs, API endpoints, keys, and CLI invocations of a model. The reasoning that call performed becomes an instruction the planner carries out.

• Before: client.messages.create(model=..., messages=[{"role": "user", "content": prompt}])
• After: “Analyze the entitlement data and classify each account as expand, hold, or at risk.”

Convert shell and child processes to in-process Python

Remove bash wrappers, heredocs, pip or npm installs, subprocess, and command-line document tools. Exit codes become exceptions; stdout parsing becomes return values. Visual QA that depended on soffice or pdftoppm becomes structural checks with python-pptx (slide count, text present, placeholders filled), with a note in the Skill that layout is not pixel-verified.

Before:

result = subprocess.run(["python3", script_path, "--mode", mode], capture_output=True)
if result.returncode != 0:
    raise RuntimeError(result.stderr)

After:

try:
    output = run_step(mode=mode)  # defined inline or loaded from the staged helper
except PipelineError as e:
    ...

Port Node-based Office generation

docx-js becomes python-docx; PptxGenJS becomes python-pptx. Port the semantics (fonts, sizes, colors, positions), not the JS API shape, and prefer one reusable builder function over translating snippets one by one. Browser JavaScript may remain inside an HTML artifact as content only; the sandbox never runs or validates it.

from docx import Document
doc = Document()
doc.add_heading(title, level=1)
doc.add_paragraph(body_text)
doc.save(os.path.join(OUTPUT_DIR, "brief.docx"))

Replace local scratch state

Workflows that persist intermediates under /tmp/{customer}/ across steps have no disk to use. Produce each intermediate as an artifact, keep its returned reference in the conversation, and pass it as an input to the next code call.

• Before: “Write state.json to /tmp/acme/ and read it back in step 3.”
• After: “Produce state.json as an artifact. In step 3, provide that artifact as a code input.”

Make bundled scripts importable and self-contained

Scripts invoked as python3 scripts/build.py in out template become functions with explicit arguments. Staged files land flat under INPUT_DIR, so there is no importable package root: remove sys.path edits and sibling imports, merge helpers into one file, and pass asset paths as arguments. For small helpers, inline the logic into the Skill’s instructions instead of shipping a .py.

• Before: sys.path.insert(0, "/mnt/skills/org/brand"); from brand_helpers import apply_theme
• After: a single self-contained scripts/build.py exposing build(notes_path, output_path, template_path), loaded from its staged file.

Map dependencies on the host's public skills

References to the host’s built-in docx, pptx, or frontend-design skills do not resolve on the Agentic Orchestrator. Point them at your own companion Skills published to the same organization, or inline the generation instructions.

• Before: Route one-pagers to /mnt/skills/public/docx/SKILL.md
• After: Read SKILL.md from the docx-brand Skill (published alongside this one).