diff --git a/dashboard/src/lib/ctxClient.ts b/dashboard/src/lib/ctxClient.ts
index c973b56..ba6581d 100644
--- a/dashboard/src/lib/ctxClient.ts
+++ b/dashboard/src/lib/ctxClient.ts
@@ -50,6 +50,8 @@ import type {
   SkillToolsRequest,
   SkillToolsResponse,
   StatusIdResponse,
+  UpdateRequest,
+  UpdateResponse,
   UpstreamRequest,
   UpstreamResponse,
 } from "./types";
@@ -145,6 +147,7 @@ async function getText(path: string): Promise<string> {
 
 export const ctx = {
   add: (req: AddRequest) => post<AddResponse>("/add", req),
+  update: (req: UpdateRequest) => post<UpdateResponse>("/update", req),
   retrieve: (req: RetrieveRequest) => post<RetrieveResponse>("/retrieve", req),
   expand: (req: ExpandRequest) => post<ExpandResponse>("/expand", req),
   forget: (req: ForgetRequest) => post<StatusIdResponse>("/forget", req),
diff --git a/dashboard/src/lib/i18n.tsx b/dashboard/src/lib/i18n.tsx
index d36d384..e9263e1 100644
--- a/dashboard/src/lib/i18n.tsx
+++ b/dashboard/src/lib/i18n.tsx
@@ -300,6 +300,22 @@ const zh: Dict = {
   "skills.detail.confidence": "置信度",
   "skills.detail.source": "来源",
   "skills.detail.createdAt": "创建时间",
+  "skills.detail.name": "名称",
+  "skills.detail.tags": "标签",
+  "skills.detail.edit": "编辑",
+  "skills.detail.save": "保存",
+  "skills.detail.saving": "保存中…",
+  "skills.detail.saved": "已保存",
+  "skills.detail.confirm": "确认",
+  "skills.detail.confirming": "确认中…",
+  "skills.detail.confirmed": "已确认",
+  "skills.detail.saveError": "保存失败",
+  "skills.detail.confirmError": "确认失败",
+  "skills.detail.state.autoGenerated": "自动生成",
+  "skills.detail.state.edited": "已编辑",
+  "skills.detail.state.confirmed": "已确认",
+  "skills.detail.editHint": "编辑后请点击「保存」使更改生效；确认后置信度将设为 100%。",
+  "skills.detail.tagsPlaceholder": "逗号分隔，如: python, rag",
 
   // env vault
   "envVault.vault.title": "环境变量保险箱",
@@ -666,6 +682,22 @@ const en: Dict = {
   "skills.detail.confidence": "Confidence",
   "skills.detail.source": "Source",
   "skills.detail.createdAt": "Created at",
+  "skills.detail.name": "Name",
+  "skills.detail.tags": "Tags",
+  "skills.detail.edit": "Edit",
+  "skills.detail.save": "Save",
+  "skills.detail.saving": "Saving…",
+  "skills.detail.saved": "Saved",
+  "skills.detail.confirm": "Confirm",
+  "skills.detail.confirming": "Confirming…",
+  "skills.detail.confirmed": "Confirmed",
+  "skills.detail.saveError": "Save failed",
+  "skills.detail.confirmError": "Confirmation failed",
+  "skills.detail.state.autoGenerated": "Auto-generated",
+  "skills.detail.state.edited": "Edited",
+  "skills.detail.state.confirmed": "Confirmed",
+  "skills.detail.editHint": "Click Save after editing to persist changes. Confirming sets confidence to 100%.",
+  "skills.detail.tagsPlaceholder": "Comma-separated, e.g. python, rag",
 
   "envVault.vault.title": "Env Vault",
   "envVault.vault.desc": "Reusable KEY=value records, stored encrypted on disk (fixed app-level key, no passphrase).",
@@ -1030,6 +1062,22 @@ const ja: Dict = {
   "skills.detail.confidence": "信頼度",
   "skills.detail.source": "ソース",
   "skills.detail.createdAt": "作成日時",
+  "skills.detail.name": "名前",
+  "skills.detail.tags": "タグ",
+  "skills.detail.edit": "編集",
+  "skills.detail.save": "保存",
+  "skills.detail.saving": "保存中…",
+  "skills.detail.saved": "保存済み",
+  "skills.detail.confirm": "確認",
+  "skills.detail.confirming": "確認中…",
+  "skills.detail.confirmed": "確認済み",
+  "skills.detail.saveError": "保存に失敗",
+  "skills.detail.confirmError": "確認に失敗",
+  "skills.detail.state.autoGenerated": "自動生成",
+  "skills.detail.state.edited": "編集済み",
+  "skills.detail.state.confirmed": "確認済み",
+  "skills.detail.editHint": "編集後に「保存」をクリックして変更を反映します。確認すると信頼度が100%になります。",
+  "skills.detail.tagsPlaceholder": "カンマ区切り, 例: python, rag",
 
   "envVault.vault.title": "環境変数ボールト",
   "envVault.vault.desc": "再利用可能な KEY=value レコードを、暗号化してローカル保存します（アプリ固定キー、パスフレーズ不要）。",
diff --git a/dashboard/src/lib/types.ts b/dashboard/src/lib/types.ts
index b5376a9..631fc8d 100644
--- a/dashboard/src/lib/types.ts
+++ b/dashboard/src/lib/types.ts
@@ -514,6 +514,24 @@ export interface SkillMdItem {
   content: string;
 }
 
+export interface UpdateRequest {
+  scope: string;
+  item_id: string;
+  name?: string;
+  description?: string;
+  body?: string;
+  parameters?: Record<string, unknown>;
+  tags?: string[];
+  confirm?: boolean;
+}
+
+export interface UpdateResponse {
+  status: string;
+  id: string;
+  confidence: number;
+  verified: boolean;
+}
+
 export interface SkillMdRequest {
   scope: string;
 }
diff --git a/dashboard/src/panels/SkillsPanel.tsx b/dashboard/src/panels/SkillsPanel.tsx
index d3dd1d5..af1bab3 100644
--- a/dashboard/src/panels/SkillsPanel.tsx
+++ b/dashboard/src/panels/SkillsPanel.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import type { ReactNode } from "react";
 
 import { Badge } from "@/components/ui/badge";
@@ -10,6 +10,8 @@ import {
   DialogHeader,
   DialogTitle,
 } from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
 import { useScope } from "@/context/ScopeContext";
 import { ctx } from "@/lib/ctxClient";
 import { useI18n } from "@/lib/i18n";
@@ -87,17 +89,66 @@ function ContentBlock({
   );
 }
 
+type SkillState = "auto-generated" | "edited" | "confirmed";
+
+function getSkillState(item: ContextItem): SkillState {
+  const confidence = item.provenance.confidence;
+  if (confidence >= 1.0 || item.provenance.verified) return "confirmed";
+  if (item.tags?.includes("edited")) return "edited";
+  return "auto-generated";
+}
+
+function SkillStateBadge({ state }: { state: SkillState }) {
+  const { t } = useI18n();
+  const colorMap: Record<SkillState, string> = {
+    "auto-generated": "bg-blue-100 text-blue-700 border-blue-200",
+    edited: "bg-yellow-100 text-yellow-700 border-yellow-200",
+    confirmed: "bg-green-100 text-green-700 border-green-200",
+  };
+  const labelMap: Record<SkillState, string> = {
+    "auto-generated": t("skills.detail.state.autoGenerated"),
+    edited: t("skills.detail.state.edited"),
+    confirmed: t("skills.detail.state.confirmed"),
+  };
+  return (
+    <span
+      className={`inline-flex items-center rounded-full border px-2 py-0.5 text-xs font-medium ${colorMap[state]}`}
+    >
+      {labelMap[state]}
+    </span>
+  );
+}
+
 function SkillDetailDialog({
   item,
   onClose,
+  onUpdated,
 }: {
   item: ContextItem | null;
   onClose: () => void;
+  onUpdated: () => void;
 }) {
   const { t } = useI18n();
+  const { scope } = useScope();
+
+  const [isEditing, setIsEditing] = useState(false);
+  const [saving, setSaving] = useState(false);
+  const [confirming, setConfirming] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [successMsg, setSuccessMsg] = useState<string | null>(null);
+
+  // Reset state when item changes
+  useEffect(() => {
+    setIsEditing(false);
+    setError(null);
+    setSuccessMsg(null);
+    setSaving(false);
+    setConfirming(false);
+  }, [item?.id]);
+
   if (!item) return null;
 
-  // Handle both string-content and dict-content skills
+  // Parse content
   const isStringContent = typeof item.content === "string";
   const dictContent =
     item.content && typeof item.content === "object"
@@ -105,64 +156,233 @@ function SkillDetailDialog({
       : null;
 
   const name = (dictContent?.name as string) || item.summary || item.id;
-  const description = dictContent?.description as string | undefined;
-  // For string-content skills, the body IS the raw content string
+  const description = (dictContent?.description as string) || "";
   const body = isStringContent
     ? (item.content as string)
-    : (dictContent?.body as string | undefined);
+    : ((dictContent?.body as string) || "");
   const parameters = dictContent?.parameters as Record<string, unknown> | undefined;
   const inputSchema = dictContent?.inputSchema as Record<string, unknown> | undefined;
   const version = dictContent?.version as string | undefined;
   const contentTags = dictContent?.tags as string[] | undefined;
-  // Show item.tags but exclude generic stage/type tags already visible as Badge
   const displayTags = [
     ...(contentTags ?? []),
     ...(item.tags ?? []).filter(
-      (t) => !["prompt_skill", "tool_skill", "mcp_skill", "prompt", "tool", "mcp"].includes(t),
+      (t) => !["prompt_skill", "tool_skill", "mcp_skill", "prompt", "tool", "mcp", "edited"].includes(t),
     ),
   ].filter((v, i, a) => a.indexOf(v) === i);
 
   const confidence = Math.round(item.provenance.confidence * 100);
   const confidenceColor =
     confidence >= 80 ? "text-green-500" : confidence >= 60 ? "text-yellow-500" : "text-red-500";
+  const skillState = getSkillState(item);
+
+  // Form state
+  const [formName, setFormName] = useState(name);
+  const [formDesc, setFormDesc] = useState(description);
+  const [formBody, setFormBody] = useState(body);
+  const [formParamsText, setFormParamsText] = useState(
+    parameters ? JSON.stringify(parameters, null, 2) : ""
+  );
+  const [formTagsText, setFormTagsText] = useState(displayTags.join(", "));
+  const [paramsError, setParamsError] = useState<string | null>(null);
+
+  function enterEditMode() {
+    setFormName(name);
+    setFormDesc(description);
+    setFormBody(body);
+    setFormParamsText(parameters ? JSON.stringify(parameters, null, 2) : "");
+    setFormTagsText(displayTags.join(", "));
+    setParamsError(null);
+    setError(null);
+    setSuccessMsg(null);
+    setIsEditing(true);
+  }
+
+  function cancelEdit() {
+    setIsEditing(false);
+    setError(null);
+    setParamsError(null);
+  }
+
+  async function handleSave() {
+    if (!item) return;
+    // Validate JSON parameters
+    let parsedParams: Record<string, unknown> | undefined;
+    if (formParamsText.trim()) {
+      try {
+        parsedParams = JSON.parse(formParamsText);
+      } catch {
+        setParamsError("Parameters must be valid JSON");
+        return;
+      }
+    }
+    setParamsError(null);
+
+    // Parse tags
+    const parsedTags = formTagsText
+      .split(/[，,]/)
+      .map((t) => t.trim())
+      .filter(Boolean);
+
+    setSaving(true);
+    setError(null);
+    setSuccessMsg(null);
+    try {
+      await ctx.update({
+        scope,
+        item_id: item.id,
+        name: formName || undefined,
+        description: formDesc || undefined,
+        body: formBody,
+        parameters: parsedParams,
+        tags: [...parsedTags, "edited"],
+      });
+      setSuccessMsg(t("skills.detail.saved"));
+      setIsEditing(false);
+      onUpdated();
+    } catch (e) {
+      setError(t("skills.detail.saveError") + ": " + (e instanceof Error ? e.message : String(e)));
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  async function handleConfirm() {
+    if (!item) return;
+    setConfirming(true);
+    setError(null);
+    setSuccessMsg(null);
+    try {
+      await ctx.update({
+        scope,
+        item_id: item.id,
+        confirm: true,
+      });
+      setSuccessMsg(t("skills.detail.confirmed"));
+      onUpdated();
+    } catch (e) {
+      setError(t("skills.detail.confirmError") + ": " + (e instanceof Error ? e.message : String(e)));
+    } finally {
+      setConfirming(false);
+    }
+  }
+
+  const isEditedUnconfirmed = skillState === "edited";
 
   return (
     <Dialog open={!!item} onOpenChange={(open) => { if (!open) onClose(); }}>
-      <DialogContent className="max-w-2xl max-h-[85vh] flex flex-col p-0 gap-0 overflow-hidden">
+      <DialogContent
+        className={`max-w-2xl max-h-[85vh] flex flex-col p-0 gap-0 overflow-hidden ${
+          isEditedUnconfirmed ? "ring-2 ring-yellow-400" : ""
+        }`}
+      >
         {/* Header */}
         <div className="px-6 pt-6 pb-4 border-b shrink-0">
           <DialogHeader>
-            <DialogTitle className="leading-snug pr-6">
-              {name}
-            </DialogTitle>
+            <div className="flex items-center gap-2 flex-wrap">
+              <DialogTitle className="leading-snug">
+                {isEditing ? (
+                  <Input
+                    value={formName}
+                    onChange={(e) => setFormName(e.target.value)}
+                    className="text-lg font-semibold h-auto py-1"
+                    placeholder={t("skills.detail.name")}
+                  />
+                ) : (
+                  name
+                )}
+              </DialogTitle>
+              <SkillStateBadge state={skillState} />
+            </div>
           </DialogHeader>
-          {description && !isStringContent && (
+          {!isEditing && description && !isStringContent && (
             <p className="mt-2 text-sm text-muted-foreground leading-relaxed">{description}</p>
           )}
-          {version && (
+          {isEditing && (
+            <div className="mt-2">
+              <Input
+                value={formDesc}
+                onChange={(e) => setFormDesc(e.target.value)}
+                className="text-sm"
+                placeholder={t("skills.detail.description")}
+              />
+            </div>
+          )}
+          {version && !isEditing && (
             <p className="mt-1 text-xs text-muted-foreground">v{version}</p>
           )}
         </div>
 
         {/* Scrollable body */}
         <div className="flex-1 overflow-y-auto px-6 py-4 space-y-5">
-          {body && (
-            <ContentBlock
-              label={t("skills.detail.body")}
-              text={body}
-              mono={false}
-            />
+          {/* Error / Success messages */}
+          {error && (
+            <div className="rounded-md bg-red-50 border border-red-200 px-3 py-2 text-sm text-red-700">
+              {error}
+            </div>
+          )}
+          {successMsg && (
+            <div className="rounded-md bg-green-50 border border-green-200 px-3 py-2 text-sm text-green-700">
+              {successMsg}
+            </div>
           )}
 
-          {parameters && (
-            <ContentBlock
-              label={t("skills.detail.parameters")}
-              text={JSON.stringify(parameters, null, 2)}
-              mono
-            />
+          {/* Edit hint */}
+          {isEditing && (
+            <p className="text-xs text-muted-foreground">{t("skills.detail.editHint")}</p>
           )}
 
-          {inputSchema && (
+          {/* Body */}
+          {isEditing ? (
+            <div>
+              <span className="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+                {t("skills.detail.body")}
+              </span>
+              <Textarea
+                value={formBody}
+                onChange={(e) => setFormBody(e.target.value)}
+                className="mt-1.5 min-h-[160px] font-mono text-xs"
+              />
+            </div>
+          ) : (
+            body && (
+              <ContentBlock label={t("skills.detail.body")} text={body} mono={false} />
+            )
+          )}
+
+          {/* Parameters */}
+          {isEditing ? (
+            <div>
+              <span className="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+                {t("skills.detail.parameters")}
+              </span>
+              <Textarea
+                value={formParamsText}
+                onChange={(e) => {
+                  setFormParamsText(e.target.value);
+                  setParamsError(null);
+                }}
+                className={`mt-1.5 min-h-[100px] font-mono text-xs ${
+                  paramsError ? "border-red-400" : ""
+                }`}
+                placeholder='{ "type": "object", "properties": {} }'
+              />
+              {paramsError && (
+                <p className="mt-1 text-xs text-red-500">{paramsError}</p>
+              )}
+            </div>
+          ) : (
+            parameters && (
+              <ContentBlock
+                label={t("skills.detail.parameters")}
+                text={JSON.stringify(parameters, null, 2)}
+                mono
+              />
+            )
+          )}
+
+          {/* Input Schema (view-only) */}
+          {!isEditing && inputSchema && (
             <ContentBlock
               label={t("skills.detail.inputSchema")}
               text={JSON.stringify(inputSchema, null, 2)}
@@ -170,36 +390,99 @@ function SkillDetailDialog({
             />
           )}
 
-          {displayTags.length > 0 && (
+          {/* Tags */}
+          {isEditing ? (
             <div>
-              <p className="text-xs font-medium text-muted-foreground uppercase tracking-wide mb-1.5">
-                Tags
-              </p>
-              <div className="flex flex-wrap gap-1.5">
-                {displayTags.map((tag) => (
-                  <Badge key={tag} variant="outline" className="text-xs font-normal">
-                    {tag}
-                  </Badge>
-                ))}
-              </div>
+              <span className="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+                {t("skills.detail.tags")}
+              </span>
+              <Input
+                value={formTagsText}
+                onChange={(e) => setFormTagsText(e.target.value)}
+                className="mt-1.5 text-sm"
+                placeholder={t("skills.detail.tagsPlaceholder")}
+              />
             </div>
+          ) : (
+            displayTags.length > 0 && (
+              <div>
+                <p className="text-xs font-medium text-muted-foreground uppercase tracking-wide mb-1.5">
+                  Tags
+                </p>
+                <div className="flex flex-wrap gap-1.5">
+                  {displayTags.map((tag) => (
+                    <Badge key={tag} variant="outline" className="text-xs font-normal">
+                      {tag}
+                    </Badge>
+                  ))}
+                </div>
+              </div>
+            )
           )}
         </div>
 
-        {/* Metadata footer */}
+        {/* Footer with actions */}
         <div className="px-6 py-3 border-t bg-muted/40 shrink-0">
-          <div className="grid grid-cols-3 gap-4 text-xs text-muted-foreground">
-            <div>
-              <p className="font-medium mb-0.5">{t("skills.detail.confidence")}</p>
-              <p className={`font-semibold ${confidenceColor}`}>{confidence}%</p>
-            </div>
-            <div>
-              <p className="font-medium mb-0.5">{t("skills.detail.source")}</p>
-              <p className="truncate">{item.provenance.source_type}</p>
+          <div className="flex items-center justify-between gap-3">
+            {/* Actions left */}
+            <div className="flex items-center gap-2">
+              {isEditing ? (
+                <>
+                  <Button
+                    size="sm"
+                    onClick={handleSave}
+                    disabled={saving}
+                    className="h-7 text-xs"
+                  >
+                    {saving ? t("skills.detail.saving") : t("skills.detail.save")}
+                  </Button>
+                  <Button
+                    size="sm"
+                    variant="outline"
+                    onClick={cancelEdit}
+                    disabled={saving}
+                    className="h-7 text-xs"
+                  >
+                    {t("common.cancel")}
+                  </Button>
+                </>
+              ) : (
+                <>
+                  <Button
+                    size="sm"
+                    variant="outline"
+                    onClick={enterEditMode}
+                    className="h-7 text-xs"
+                  >
+                    {t("skills.detail.edit")}
+                  </Button>
+                  {skillState !== "confirmed" && (
+                    <Button
+                      size="sm"
+                      variant="secondary"
+                      onClick={handleConfirm}
+                      disabled={confirming}
+                      className="h-7 text-xs"
+                    >
+                      {confirming
+                        ? t("skills.detail.confirming")
+                        : t("skills.detail.confirm")}
+                    </Button>
+                  )}
+                </>
+              )}
             </div>
-            <div>
-              <p className="font-medium mb-0.5">{t("skills.detail.createdAt")}</p>
-              <p>{new Date(item.created_at).toLocaleDateString()}</p>
+
+            {/* Metadata right */}
+            <div className="flex items-center gap-4 text-xs text-muted-foreground">
+              <div className="text-right">
+                <p className={`font-semibold ${confidenceColor}`}>{confidence}%</p>
+                <p className="text-[10px]">{t("skills.detail.confidence")}</p>
+              </div>
+              <div className="text-right">
+                <p className="truncate max-w-[100px]">{item.provenance.source_type}</p>
+                <p className="text-[10px]">{t("skills.detail.source")}</p>
+              </div>
             </div>
           </div>
         </div>
@@ -292,7 +575,7 @@ export function SkillsPanel() {
   const [selectedItem, setSelectedItem] = useState<ContextItem | null>(null);
   const [downloadingMd, setDownloadingMd] = useState(false);
 
-  useEffect(() => {
+  const loadItems = useCallback(() => {
     let cancelled = false;
     setLoading(true);
     ctx
@@ -311,6 +594,27 @@ export function SkillsPanel() {
     };
   }, [scope]);
 
+  useEffect(() => {
+    const cancel = loadItems();
+    return cancel;
+  }, [loadItems]);
+
+  function handleUpdated() {
+    // Reload items and update the selected item in the dialog
+    loadItems();
+    if (selectedItem) {
+      // Briefly close and reopen to refresh — or just re-fetch the item
+      const itemId = selectedItem.id;
+      ctx
+        .items({ scope, stage: "skill" })
+        .then((res) => {
+          const updated = res.items.find((it) => it.id === itemId);
+          if (updated) setSelectedItem(updated);
+        })
+        .catch(() => {});
+    }
+  }
+
   async function handleDownloadSkillMd() {
     setDownloadingMd(true);
     try {
@@ -342,7 +646,11 @@ export function SkillsPanel() {
 
   return (
     <div className="space-y-4 p-6">
-      <SkillDetailDialog item={selectedItem} onClose={() => setSelectedItem(null)} />
+      <SkillDetailDialog
+        item={selectedItem}
+        onClose={() => setSelectedItem(null)}
+        onUpdated={handleUpdated}
+      />
 
       <div className="grid gap-4 lg:grid-cols-3">
         {/* Skills list */}
diff --git a/src/contextseek/http/server.py b/src/contextseek/http/server.py
index ecd4acc..f0861ce 100644
--- a/src/contextseek/http/server.py
+++ b/src/contextseek/http/server.py
@@ -20,6 +20,7 @@
     deserialize_context_item,
     serialize_context_item,
 )
+from contextseek.domain.provenance import Provenance
 
 try:
     from fastapi import FastAPI, HTTPException
@@ -165,6 +166,17 @@ class ItemsRequest(BaseModel):
     stage: str | None = None
 
 
+class UpdateRequest(BaseModel):
+    scope: str
+    item_id: str
+    name: str | None = None
+    description: str | None = None
+    body: str | None = None
+    parameters: dict[str, Any] | None = None
+    tags: list[str] | None = None
+    confirm: bool = False
+
+
 class PlugInstallRequest(BaseModel):
     linker: str
     dry_run: bool = False
@@ -174,6 +186,7 @@ class PlugInstallRequest(BaseModel):
 
 _API_ROOT_SEGMENTS: set[str] = {
     "add",
+    "update",
     "retrieve",
     "expand",
     "forget",
@@ -1073,6 +1086,77 @@ async def add_item(req: AddRequest) -> dict[str, Any]:
         item = ctx.add(req.content, scope=req.scope, source=req.source, tags=req.tags)
         return {"id": item.id, "stage": item.stage.value}
 
+    @app.post("/update")
+    async def update_item(req: UpdateRequest) -> dict[str, Any]:
+        """Update an existing ContextItem's content fields.
+
+        Only provided (non-None) fields are updated; omitted fields are left
+        unchanged.  When ``confirm`` is True the item's provenance confidence is
+        set to 1.0 and verified to True.
+        """
+        ref = (
+            req.item_id
+            if req.item_id.startswith(ctx.resolver.scheme)
+            else ctx.resolver.ref_for(req.scope, req.item_id)
+        )
+        payload = ctx.adapter.read(ref)
+        if payload is None:
+            raise HTTPException(
+                status_code=404,
+                detail=f"item not found: {req.item_id} in scope {req.scope}",
+            )
+        try:
+            item = deserialize_context_item(payload)
+        except (KeyError, TypeError, ValueError) as exc:
+            raise HTTPException(
+                status_code=400,
+                detail=f"failed to deserialize item: {exc}",
+            ) from exc
+
+        # Update content dict fields when content is a dict (skill IR)
+        if isinstance(item.content, dict):
+            content = dict(item.content)
+            if req.name is not None:
+                content["name"] = req.name
+            if req.description is not None:
+                content["description"] = req.description
+            if req.body is not None:
+                content["body"] = req.body
+            if req.parameters is not None:
+                content["parameters"] = req.parameters
+            if req.tags is not None:
+                content["tags"] = list(req.tags)
+            item.content = content
+        elif req.body is not None:
+            # Plain string content — replace body only
+            item.content = req.body
+
+        # Apply tags at item level when provided
+        if req.tags is not None:
+            item.tags = list(req.tags)
+
+        # Handle confirmation
+        if req.confirm:
+            item.provenance = Provenance(
+                source_type=item.provenance.source_type,
+                source_id=item.provenance.source_id,
+                confidence=1.0,
+                verified=True,
+                created_by=item.provenance.created_by,
+                context=item.provenance.context,
+            )
+
+        # Persist
+        updated_payload = serialize_context_item(item)
+        ctx.adapter.write(ref, updated_payload)
+
+        return {
+            "status": "ok",
+            "id": req.item_id,
+            "confidence": item.provenance.confidence,
+            "verified": item.provenance.verified,
+        }
+
     @app.post("/retrieve")
     async def retrieve(req: RetrieveRequest) -> dict[str, Any]:
         response = ctx.retrieve(