Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

feat(skills): add getting-started onboarding (#18891)

tobi_kl52b2ef6dcc76
diff --git a/web/src/features/skills/components/ImportSkillsDialog.tsx b/web/src/features/skills/components/ImportSkillsDialog.tsx
index 3812bc21d4..4f043020ff 100644
--- a/web/src/features/skills/components/ImportSkillsDialog.tsx
+++ b/web/src/features/skills/components/ImportSkillsDialog.tsx
@@ -271,7 +271,7 @@ export function ImportSkillsDialog({
>
<Tabs.Trigger
value="local"
- label="Local files"
+ label="Upload files"
disabled={busy}
/>
<Tabs.Trigger value="cli" label="CLI" disabled={busy} />
diff --git a/web/src/features/skills/components/SkillEditor.tsx b/web/src/features/skills/components/SkillEditor.tsx
index eca3c0ffc8..41f9bea5a5 100644
--- a/web/src/features/skills/components/SkillEditor.tsx
+++ b/web/src/features/skills/components/SkillEditor.tsx
@@ -11,7 +11,7 @@ import { useStore } from "zustand";
import {
Download,
Loader2,
- Plus,
+ Pencil,
TriangleAlert,
RotateCcw,
Save,
@@ -439,7 +439,7 @@ export function SkillEditor({
if (view.kind === "version") await view.onEdit();
}}
>
- <Plus className="icon-base mr-1.5" />
+ <Pencil className="icon-base mr-1.5" />
{view.kind === "version" && view.hasDraft ? "Resume draft" : "Edit"}
</Button>
) : (
diff --git a/web/src/features/skills/components/SkillsPage.tsx b/web/src/features/skills/components/SkillsPage.tsx
index 8b362e32ee..3d213353b4 100644
--- a/web/src/features/skills/components/SkillsPage.tsx
+++ b/web/src/features/skills/components/SkillsPage.tsx
@@ -1,6 +1,14 @@
import { useMemo } from "react";
import Link from "next/link";
-import { Download, FileCode2, Plus, Terminal, Trash } from "lucide-react";
+import {
+ BarChart4,
+ Download,
+ FileCode2,
+ GitBranch,
+ Plus,
+ Terminal,
+ Trash,
+} from "lucide-react";
import { NumberParam, useQueryParams, withDefault } from "use-query-params";
import Page from "@/src/components/layouts/page";
import { Button } from "@/src/components/ui/button";
@@ -8,6 +16,7 @@ import { Button as DesignSystemButton } from "@/src/components/design-system/But
import { Dialog } from "@/src/components/design-system/Dialog/Dialog";
import { DialogController } from "@/src/components/design-system/DialogController/DialogController";
import { PaginationBar } from "@/src/components/design-system/PaginationBar/PaginationBar";
+import { SplashScreen } from "@/src/components/ui/splash-screen";
import {
Table,
type AsyncTableData,
@@ -277,7 +286,7 @@ function SkillsList({
}),
];
- return (
+ const table = (
<DataTableControlsProvider tableName="skills" defaultSidebarCollapsed>
<div className="flex h-full min-h-0 flex-col">
<div className="flex items-center gap-2 px-3 py-2 md:p-0">
@@ -358,34 +367,26 @@ function SkillsList({
>
{({ openDialog }) => (
<div className="flex min-h-0 flex-1 flex-col">
- {isEmptyProject ? (
- <EmptySkills
- canCreate={canDelete}
- href={`/project/${projectId}/skills/new`}
- onOpen={() => capture("skills:new_form_open")}
- />
- ) : (
- <Table
- tableName="skills"
- columns={columns}
- data={tableData}
- loadingRowCount={Math.min(paginationState.pageSize, 8)}
- noResultsMessage="No skills match your search or filters."
- actions={(skill) => [
- {
- type: "item",
- id: "delete",
- title: "Delete skill",
- icon: Trash,
- variant: "destructive",
- disabled: canDelete
- ? undefined
- : { reason: "You do not have write access" },
- onClick: () => openDialog(skill.name),
- },
- ]}
- />
- )}
+ <Table
+ tableName="skills"
+ columns={columns}
+ data={tableData}
+ loadingRowCount={Math.min(paginationState.pageSize, 8)}
+ noResultsMessage="No skills match your search or filters."
+ actions={(skill) => [
+ {
+ type: "item",
+ id: "delete",
+ title: "Delete skill",
+ icon: Trash,
+ variant: "destructive",
+ disabled: canDelete
+ ? undefined
+ : { reason: "You do not have write access" },
+ onClick: () => openDialog(skill.name),
+ },
+ ]}
+ />
<PaginationBar
mode="offset"
totalCount={skills.data?.meta.totalItems ?? null}
@@ -399,6 +400,25 @@ function SkillsList({
</div>
</DataTableControlsProvider>
);
+
+ return (
+ <ImportSkillsDialog projectId={projectId}>
+ {(openImportDialog) =>
+ isEmptyProject ? (
+ <div className="min-h-0 flex-1 overflow-y-auto">
+ <EmptySkills
+ projectId={projectId}
+ canCreate={canDelete}
+ onOpen={() => capture("skills:new_form_open")}
+ onImport={openImportDialog}
+ />
+ </div>
+ ) : (
+ table
+ )
+ }
+ </ImportSkillsDialog>
+ );
}
function NewSkillButton({
@@ -427,27 +447,75 @@ function NewSkillButton({
}
function EmptySkills({
+ projectId,
canCreate,
- href,
onOpen,
+ onImport,
}: {
+ projectId: string;
canCreate: boolean;
- href: string;
onOpen: () => void;
+ onImport: () => void;
}) {
return (
- <div className="flex flex-1 flex-col items-center justify-center gap-3 py-24 text-center">
- <FileCode2 className="text-muted-foreground icon-xl" />
- <div>
- <h2 className="font-bold">Create your first skill</h2>
- <p className="text-muted-foreground mt-1 text-sm">
- Skills bundle instructions and supporting files into immutable
- versions.
+ <SplashScreen
+ title="Get Started with Skills"
+ description="Create, version, and distribute reusable agent skills from one place. Start with a new skill or import the skills your team already uses."
+ primaryAction={{
+ label: "New skill",
+ component: (
+ <NewSkillButton
+ canCreate={canCreate}
+ href={`/project/${projectId}/skills/new`}
+ onOpen={onOpen}
+ />
+ ),
+ }}
+ secondaryAction={{
+ label: "Import skills",
+ component: (
+ <DesignSystemButton
+ text="Import skills"
+ icon={Download}
+ variant="secondary"
+ disabled={!canCreate}
+ onClick={onImport}
+ />
+ ),
+ }}
+ valuePropositions={[
+ {
+ title: "Manage Skills",
+ description:
+ "Create a new skill directly in the Langfuse UI, upload existing skill files, or push skills from your repository with the CLI.",
+ icon: FileCode2,
+ },
+ {
+ title: "Track skill usage",
+ description:
+ "See which skills your agents actually load and explore the traces where they are used.",
+ icon: BarChart4,
+ },
+ {
+ title: "Version and iterate",
+ description:
+ "Save changes as immutable versions and use labels to control which version your agents receive.",
+ icon: GitBranch,
+ },
+ {
+ title: "Use via CLI or SDK",
+ description:
+ "Install skills into your agent's skills directory with the CLI or fetch them with the Langfuse SDK.",
+ icon: Terminal,
+ },
+ ]}
+ >
+ {!canCreate ? (
+ <p className="text-muted-foreground text-center text-sm">
+ Ask a project member with write access to create or import your first
+ skill.
</p>
- </div>
- {canCreate ? (
- <NewSkillButton canCreate={canCreate} href={href} onOpen={onOpen} />
) : null}
- </div>
+ </SplashScreen>
);
}