Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { useEffect, useMemo, useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { Info, AlertTriangle } from 'lucide-react';
import { useForm, Controller, FormProvider } from 'react-hook-form';
import {
Label,
Input,
Button,
Skeleton,
TextareaAutosize,
useToastContext,
} from '@librechat/client';
import {
InvocationMode,
SKILL_NAME_PATTERN,
SKILL_NAME_MAX_LENGTH,
SKILL_DESCRIPTION_MAX_LENGTH,
} from 'librechat-data-provider';
import type { TSkill, TSkillWarning, TUpdateSkillPayload } from 'librechat-data-provider';
import { useGetSkillQuery, useUpdateSkillMutation } from '~/data-provider';
import { useLocalize, useSkillPermissions } from '~/hooks';
import SkillContentEditor from './SkillContentEditor';
import CategorySelector from './CategorySelector';
import DeleteSkill from '../dialogs/DeleteSkill';
import { ShareSkill } from '../buttons';
import { cn } from '~/utils';
interface SkillFormValues {
name: string;
description: string;
body: string;
category: string;
invocationMode: InvocationMode;
}
interface SkillFormProps {
skillId: string;
}
function toValues(skill: TSkill | undefined): SkillFormValues | undefined {
if (!skill) {
return undefined;
}
return {
name: skill.name,
description: skill.description,
body: skill.body ?? '',
category: skill.category ?? '',
// Phase 1: backend doesn't persist invocationMode yet — default to `auto`
// so the picker has a selection. UI state only; discarded on save until
// the backend lands the column.
invocationMode: skill.invocationMode ?? InvocationMode.auto,
};
}
export default function SkillForm({ skillId }: SkillFormProps) {
const localize = useLocalize();
const navigate = useNavigate();
const { showToast } = useToastContext();
const [warnings, setWarnings] = useState<TSkillWarning[] | null>(null);
const skillQuery = useGetSkillQuery(skillId);
const skill = skillQuery.data;
const permissions = useSkillPermissions(skill);
const values = useMemo(() => toValues(skill), [skill]);
const [isEditingContent, setIsEditingContent] = useState(false);
const methods = useForm<SkillFormValues>({
defaultValues: {
name: '',
description: '',
body: '',
category: '',
invocationMode: InvocationMode.auto,
},
values,
mode: 'onChange',
});
const {
control,
handleSubmit,
reset,
setError,
formState: { isDirty, isValid, isSubmitting, errors },
} = methods;
useEffect(() => {
setWarnings(null);
}, [skillId]);
const updateSkill = useUpdateSkillMutation({
onSuccess: (updated) => {
showToast({
status: updated.warnings && updated.warnings.length > 0 ? 'warning' : 'success',
message: localize('com_ui_skill_updated'),
});
setWarnings(updated.warnings ?? null);
reset(toValues(updated));
},
onError: (error: unknown) => {
const status = (error as { response?: { status?: number } })?.response?.status;
if (status === 409) {
showToast({ status: 'warning', message: localize('com_ui_skill_update_conflict') });
skillQuery.refetch();
return;
}
const message =
(error as { response?: { data?: { message?: string } } })?.response?.data?.message ??
localize('com_ui_skill_update_error');
showToast({ status: 'error', message });
},
});
// `useCallback` would be a no-op: `updateSkill` is a React Query mutation
// result with an unstable identity, and `handleSubmit` doesn't use
// `onSubmit` as a memo dependency.
const onSubmit = (data: SkillFormValues) => {
if (!skill || updateSkill.isLoading) {
return;
}
const trimmedName = data.name.trim();
if (!SKILL_NAME_PATTERN.test(trimmedName)) {
setError('name', { message: localize('com_ui_skill_name_invalid') });
return;
}
const payload: TUpdateSkillPayload = {
name: trimmedName,
description: data.description.trim(),
body: data.body,
category: data.category || undefined,
// `invocationMode` is deliberately NOT forwarded to the backend: the
// column doesn't exist yet. Phase 2 will promote it to a first-class
// payload field.
};
updateSkill.mutate({
id: skill._id,
expectedVersion: skill.version,
payload,
});
};
if (skillQuery.isLoading || permissions.isLoading) {
return (
<div className="w-full px-4 py-2">
<Skeleton className="mb-3 h-10 w-72" />
<Skeleton className="mb-3 h-20 w-full" />
<Skeleton className="h-64 w-full" />
</div>
);
}
if (skillQuery.isError || !skill) {
return (
<div className="text-text-secondary w-full px-4 py-6 text-sm">
<p className="text-text-primary font-medium">{localize('com_ui_skill_not_found')}</p>
<p>{localize('com_ui_skill_not_found_description')}</p>
</div>
);
}
const readOnly = !permissions.canEdit;
const saveDisabled = !isDirty || !isValid || isSubmitting || updateSkill.isLoading;
return (
<FormProvider {...methods}>
<form
onSubmit={handleSubmit(onSubmit)}
className="w-full px-4 py-2"
aria-label={localize('com_ui_skill_edit_title')}
>
<h1 className="sr-only">{localize('com_ui_skill_edit_title')}</h1>
<div className="mb-1 flex flex-col items-center justify-between font-bold sm:text-xl md:mb-0 md:text-2xl">
<div className="flex w-full flex-col items-start justify-between gap-2 sm:flex-row sm:items-center">
<Controller
name="name"
control={control}
rules={{
required: localize('com_ui_skill_name_required'),
pattern: {
value: SKILL_NAME_PATTERN,
message: localize('com_ui_skill_name_invalid'),
},
maxLength: {
value: SKILL_NAME_MAX_LENGTH,
message: localize('com_ui_skill_name_too_long', {
0: String(SKILL_NAME_MAX_LENGTH),
}),
},
}}
render={({ field }) => (
<div className="relative mb-1 flex w-full flex-col sm:w-auto md:mb-0">
<Input
{...field}
id="skill-name"
type="text"
readOnly={readOnly}
className="peer text-text-primary me-2 w-full p-2 text-2xl"
placeholder=" "
tabIndex={0}
aria-label={localize('com_ui_name')}
aria-required="true"
aria-invalid={errors.name ? 'true' : 'false'}
aria-describedby={errors.name ? 'skill-name-error' : undefined}
/>
<label
htmlFor="skill-name"
className="bg-surface-primary-alt text-text-secondary peer-focus:text-text-primary pointer-events-none absolute inset-s-3 -top-1 origin-[0] translate-y-3 scale-100 rounded px-1 text-base transition-transform duration-200 peer-placeholder-shown:translate-y-3 peer-placeholder-shown:scale-100 peer-focus:-translate-y-2 peer-focus:scale-75 peer-[:not(:placeholder-shown)]:-translate-y-2 peer-[:not(:placeholder-shown)]:scale-75 rtl:origin-right"
>
{localize('com_ui_name')}*
</label>
<div
id="skill-name-error"
className={cn(
'text-text-destructive mt-1 w-56 text-sm',
errors.name ? 'visible h-auto' : 'invisible h-0',
)}
role={errors.name ? 'alert' : undefined}
>
{errors.name ? errors.name.message : ' '}
</div>
</div>
)}
/>
<div className="flex shrink-0 items-center gap-2">
<CategorySelector />
<ShareSkill skill={skill} />
{permissions.canDelete && (
<DeleteSkill
skillId={skill._id}
skillName={skill.name}
onDelete={() => navigate('/skills', { replace: true })}
/>
)}
</div>
</div>
</div>
<div className="text-text-secondary mt-1 flex items-center gap-2 text-xs">
<span>{localize('com_ui_skill_version', { 0: String(skill.version) })}</span>
<span aria-hidden="true">·</span>
<span>{skill.authorName}</span>
</div>
{readOnly && (
<div
role="note"
className="border-status-warning-border bg-status-warning-subtle text-status-warning mt-4 flex items-start gap-2 rounded-md border p-3 text-sm"
>
<Info className="mt-0.5 size-4 shrink-0" aria-hidden="true" />
<span>{localize('com_ui_skill_no_edit_permission')}</span>
</div>
)}
{warnings && warnings.length > 0 && (
<div
role="alert"
className="border-status-warning-border bg-status-warning-subtle text-status-warning mt-4 flex flex-col gap-1 rounded-md border p-3 text-sm"
>
<div className="flex items-center gap-2 font-semibold">
<AlertTriangle className="size-4" aria-hidden="true" />
{localize('com_ui_skill_warnings')}
</div>
<ul className="ms-6 list-disc">
{warnings.map((w) => (
<li key={`${w.field}:${w.code}`}>{w.message}</li>
))}
</ul>
</div>
)}
<div className="mt-4 flex w-full flex-col gap-4">
<Controller
name="description"
control={control}
rules={{
required: localize('com_ui_skill_description_required'),
maxLength: {
value: SKILL_DESCRIPTION_MAX_LENGTH,
message: localize('com_ui_skill_description_too_long', {
0: String(SKILL_DESCRIPTION_MAX_LENGTH),
}),
},
}}
render={({ field }) => (
<div className="flex flex-col">
<Label
htmlFor="skill-description"
variant="secondary"
className="mb-1 text-sm font-medium"
>
{localize('com_ui_description')}
<span className="text-text-destructive ms-0.5">*</span>
</Label>
<TextareaAutosize
variant="framed"
focusOutline="hidden"
{...field}
id="skill-description"
readOnly={readOnly}
minRows={2}
maxRows={6}
aria-label={localize('com_ui_description')}
aria-invalid={errors.description ? 'true' : 'false'}
aria-describedby={errors.description ? 'skill-description-error' : undefined}
className="w-full resize-none p-3 text-sm"
/>
<p className="text-text-secondary mt-1 text-xs">
{localize('com_ui_skill_description_field_hint')}
</p>
{errors.description && (
<p
id="skill-description-error"
className="text-text-destructive mt-1 text-sm"
role="alert"
>
{errors.description.message}
</p>
)}
</div>
)}
/>
<SkillContentEditor
name="body"
isEditing={isEditingContent}
setIsEditing={setIsEditingContent}
/>
{!readOnly && (
<div className="mt-4 flex items-center justify-end gap-2">
<Button
type="button"
variant="outline"
onClick={() => reset(values)}
disabled={!isDirty}
>
{localize('com_ui_reset')}
</Button>
<Button
type="submit"
disabled={saveDisabled}
aria-disabled={saveDisabled || undefined}
className="w-full sm:w-auto"
>
{localize('com_ui_save')}
</Button>
</div>
)}
</div>
</form>
</FormProvider>
);
}