| name | truefoundry-agents |
| description | UI-first guide for TrueFoundry Agent Registry. Use when creating, publishing, sharing, editing, testing, or attaching MCP servers and skills to TrueFoundry Agents. Agent authoring is not API-driven. |
| license | MIT |
| compatibility | Requires browser access to the TrueFoundry dashboard |
| allowed-tools | Bash(tfy*) |
Agents
Guide the user through the TrueFoundry Agent Registry UI.
Agent authoring and interaction are dashboard workflows. Do not try to create, publish, edit, invoke, or delete agents through the API.
Use this skill when the user wants to:
- Create a TrueFoundry Agent.
- Register or manage a Remote Agent.
- Edit an existing agent configuration.
- Publish a new agent version.
- Attach MCP servers to an agent.
- Attach skills from the Skills Registry.
- Manage agent collaborators.
- Test an agent in the Agent Playground.
- Find where to monitor an agent.
Preflight
- Verify
tfy login is complete. If not, use truefoundry-onboard.
- Ask the user for the tenant URL if it is not already known.
- Open the TrueFoundry dashboard and guide the user through the UI.
Do not ask for API keys for agent authoring.
Create a TrueFoundry Agent
Direct the user to:
TrueFoundry Dashboard -> Agent Registry -> Create New Agent -> Build Agent on TrueFoundry
In Agent Playground:
- Select a model from AI Gateway.
- Write the system instructions.
- Add MCP servers from the MCP Servers selector if tools are needed.
- Add skills from the Skills selector if reusable instructions are needed.
- Test in the chat interface.
- Click
Save Agent.
- Choose
Save New Agent for a new agent or Save New Version to publish a new version of an existing agent.
Edit an Existing Agent
Direct the user to:
TrueFoundry Dashboard -> Agent Registry -> Manage
Editable fields include:
- Name
- Description
- Tags
- Collaborators
- Model
- System instructions
- MCP servers
- Attached skills
After edits, test in the playground and save a new version.
Attach MCP Servers
In Agent Playground:
- Click
+ next to MCP Servers.
- Search or browse available MCP servers.
- Select the needed tools.
- Test the agent before saving.
If the MCP server does not exist yet, use truefoundry-mcp-servers first.
Attach Skills
In Agent Playground:
- Click
+ next to Skills.
- Select a skill from the Skills Registry.
- Choose the version to pin.
- Decide whether to preload
SKILL.md.
- Test the agent before saving.
Use preload only for short, always-relevant skills. Leave it off for long or situational skills.
If the skill does not exist yet, use truefoundry-skills-registry first.
Collaborators
Use the agent edit form to grant:
- Agent Manager: can edit/manage the agent.
- Agent Access: can use/invoke the agent.
For broader teams and roles, use truefoundry-platform.
Remote Agents
For agents running outside TrueFoundry:
TrueFoundry Dashboard -> Agent Registry -> Create New Agent -> Remote Agent
Collect:
- Agent name
- Description
- Runtime endpoint or integration details shown by the UI
- Collaborators
- Tags
Then guide the user through the UI form.
Delete
Do not delete agents for the user. If deletion is requested, direct them to the dashboard:
TrueFoundry Dashboard -> Agent Registry -> Manage -> delete from the UI
<success_criteria>
- The user knows the exact UI path for the agent task.
- The agent does not claim API-based agent authoring.
- Agent creation/editing/publishing happens through Agent Registry or Agent Playground.
- MCP servers and Skills Registry are routed to their own skills when needed.
</success_criteria>
