Skip to content

docs: add Pods "Agent tools" page documenting the Pods skill - #84

Merged
axel-ext-dust merged 2 commits into
mainfrom
docs/pods-agent-tools
Aug 28, 2026
Merged

docs: add Pods "Agent tools" page documenting the Pods skill#84
axel-ext-dust merged 2 commits into
mainfrom
docs/pods-agent-tools

Conversation

@axel-ext-dust

@axel-ext-dust axel-ext-dust commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

What

Adds a dedicated documentation page for the tools agents get through the Pods skill, answering a recurring customer question ("do we have documentation on pod tools?") that currently has no docs answer. Also standardizes the skill/tools terminology across all Pods pages.

Terminology standard applied throughout

  • Pods = the feature
  • The Pods skill (singular) = the default agent capability for working with Pods
  • Tools = the individual actions the skill provides (e.g. create_tasks)
  • "Pod tools" is acknowledged once as customer shorthand on the new page, never used as a term
  • "Functions" is never used (reserved wording, avoids confusion)

Files changed

  • docs/user-documentation/pods/agent-tools.mdx (new): full inventory of the Pods skill tools, grouped by area (Pod management, members, conversations, knowledge, settings, tasks, files), with a naming note, a permissions section, and links to existing Pods pages. Tool names verified against the live Pods skill (pod_manager: 16 tools, pod_tasks: 4 tools).
  • docs/user-documentation/pods/overview.mdx: "The Pods skill" section now says the skill "provides a set of tools", extends the capability bullets (knowledge search, Pod/member/settings management), and links to the new Agent tools page from the section and "Where to go next".
  • docs/user-documentation/pods/tasks.mdx: replace the generic Overview pointer with a link to Agent tools for the full tool list.
  • docs/user-documentation/pods/conversations.mdx: same cross-link; also name the exact tool ("the Pods skill's list_pods tool" instead of "list tool").
  • docs/user-documentation/pods/files.mdx: same cross-link to Agent tools.
  • docs.json: add docs/user-documentation/pods/agent-tools to the Pods navigation group, between Frames and Admin controls.

Context

Requested in this Slack thread: the Pods docs mention the Pods skill in prose but nowhere list the actual tools, while the "everything a human can do, an agent can do" principle is a key selling point.

@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Dust 🟢 Ready View Preview Aug 27, 2026, 8:14 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@axel-ext-dust
axel-ext-dust merged commit 7cdf9c6 into main Aug 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants