Document dashboard template onboarding

[indykish]

Summary

• Documents the dashboard Add template flow for workspace templates on the Templates and Installing a fleet pages.
• Adds the Jul 03, 2026 changelog entry for dashboard template onboarding, simple empty states, Models navigation, and smoother route loading.

Test Coverage

Docs-only change; no runtime code paths changed.

Pre-Landing Review

The app branch links users to /fleets/templates#writing-your-own; this Pull Request (PR) keeps that destination valid and adds the dashboard Add template path on the same page.

Documentation

This PR is the companion docs change for agentsfleet PR agentsfleet/agentsfleet#471.

Test plan

• make lint
• gitleaks detect --no-banner

Greptile Summary

This PR documents the new dashboard Add template flow, letting workspace owners onboard a GitHub-hosted fleet template without leaving the UI. It also adds the Jul 03, 2026 changelog entry covering the same feature alongside empty-state copy, Models navigation, and route-loading improvements.

• changelog.mdx — new <Update> block for Jul 03, 2026 with four "What's new" bullets; format matches adjacent entries.
• fleets/install.mdx — marks TRIGGER.md as optional, adds Dashboard as the first onboarding bullet, and reorders the list to Dashboard → Workspace API → Platform API.
• fleets/templates.mdx — adds the "Add a workspace template from the dashboard" section and updates most cross-references to link to it; the "Sharing" section still uses the old (dashboard or API) phrasing and is the one reference that wasn't updated.

Confidence Score: 5/5

Docs-only change with no runtime code paths; safe to merge.

All three files are documentation. The changelog entry, install.mdx updates, and new templates.mdx section are accurate and internally consistent. The one missed update (Sharing section wording) is a cosmetic inconsistency that doesn't misdirect users.

fleets/templates.mdx — the Sharing section at line 87 still uses the old phrasing and is the only cross-reference not updated to link to the new Add template anchor.

Important Files Changed

Filename	Overview
changelog.mdx	Adds Jul 03, 2026 changelog entry covering dashboard Add template, empty states, Models navigation, and route motion fixes. Format is consistent with adjacent entries.
fleets/install.mdx	Updates TRIGGER.md from required to optional, adds Dashboard as the primary onboarding method, and reorders the bullet list to Dashboard → Workspace tier → Platform tier. Accurate and internally consistent.
fleets/templates.mdx	Adds the "Add a workspace template from the dashboard" section and updates several cross-references to use the new Add template link — but the Sharing section at line 87 retains the old "(dashboard or API)" phrasing and is missing the Add template link added elsewhere.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[GitHub repo with SKILL.md] --> B{Onboarding path}
    B -->|Dashboard| C[Open Fleets - Install fleet]
    B -->|Workspace API| D[POST workspace fleet-templates]
    B -->|Platform API| E[POST admin fleet-templates]
    C --> F[Click Add template]
    F --> G[Enter owner/repo]
    G --> H[Dashboard validates SKILL.md]
    H -->|Valid| I[Template in workspace gallery]
    H -->|Invalid| J[UZ-AGT-* error]
    D --> I
    E --> K[Template in platform catalogue]
    I --> L[agentsfleet install --template id]
    K --> L
    L --> M[Fleet is live]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[GitHub repo with SKILL.md] --> B{Onboarding path}
    B -->|Dashboard| C[Open Fleets - Install fleet]
    B -->|Workspace API| D[POST workspace fleet-templates]
    B -->|Platform API| E[POST admin fleet-templates]
    C --> F[Click Add template]
    F --> G[Enter owner/repo]
    G --> H[Dashboard validates SKILL.md]
    H -->|Valid| I[Template in workspace gallery]
    H -->|Invalid| J[UZ-AGT-* error]
    D --> I
    E --> K[Template in platform catalogue]
    I --> L[agentsfleet install --template id]
    K --> L
    L --> M[Fleet is live]

Loading

_{Reviews (2): Last reviewed commit: "Update changelog.mdx" | Re-trigger Greptile}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
agentsfleet	🟢 Ready	View Preview	Jul 3, 2026, 3:47 AM

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