Build an App
Write an HTML component your agent opens in the conversation, give it tools, and offer it through a skill.
All the steps presented below can be autonomously handled through your AI agent (Claude Desktop) and executed for you, except publishing: you publish, in Skilder or on the version card your agent shows. See Author with AI.
An App is an HTML component you write, such as a form, a dashboard or a picker. Your agent opens it in the conversation and you use it there. It calls only the tools you give it.
Before you start
- Your agent runs in an MCP client that renders cards. In one that does not, the App cannot show.
- The tools the App needs are installed in the workspace.
Create the App
On Capabilities > Apps, click Add App. Type a Name and a Description, then click Create app. Skilder opens its editor, and the App starts as a page that runs as is and calls no tool.
Write the component
Click Edit and open the Editor tab. The component is one HTML page. It reaches Skilder only through @skilder-ai/app-sdk, imported from a <script type="module">:
<ul id="out"></ul>
<script type="module">
import { ready, call, setContext } from '@skilder-ai/app-sdk';
const { tools } = await ready;
const rows = await call(tools[0], {});
document.getElementById('out').replaceChildren(
...rows.items.map((r) => Object.assign(document.createElement('li'), { textContent: r.name })),
);
await setContext('The user is looking at ' + rows.items.length + ' rows.');
</script>| Function | Does |
|---|---|
ready | Resolves with the App, its tool names, the theme and the arguments it was opened with. |
call(tool, args) | Calls one of the App's tools and returns the result. |
tell(text) | Adds a visible message to the conversation. Up to 4,000 characters, one per second. |
setContext(text) | Gives your agent silent context. Each call replaces the previous one. |
onTheme(callback) | Runs when the theme switches between light and dark. |
The App has no network access. A tool result reaches your agent only through tell or setContext.
Give it tools
On the Tools tab, click Manage Tools and pick the tools the App calls, read and write. The App calls these and no others. The Editor names any tool the HTML calls that is not on the list.
Preview it
On the Editor tab, type any arguments in Arguments (CLI-style) and click Preview. Tool calls are live and run as you, writes included. What the App sends with tell and setContext prints in the Console. Click Source to go back to the HTML.
Publish it
Click Publish. An App follows the same draft and publish lifecycle as a skill. See Publish and version.
Offer it through a skill
Open a skill and click Edit. In its settings panel, under Apps, click Manage Apps, pick the App and click Update. Then publish the skill. An agent that learns the skill gets the App's name, its description and the call that opens it.
Arguments
Your agent opens an App by name, with optional arguments:
open_app(name="Expense report", args="--period 30")The App reads them from ready as a list, here ["--period", "30"]. Say in the skill's instructions which arguments the App accepts. They are written by the model, so check each value before you use it.
Check it worked
Ask your agent to open the App by name. It shows in the conversation, and its openings and calls appear on the App's Activity tab.
Next
- Activity, to see how the App is used across the workspace.

