selftune 0.2.18 → 0.2.19

package/packages/ui/src/components/EvolutionTimeline.tsx

@@ -25,27 +25,43 @@ const ACTION_ICON: Record<string, React.ReactNode> = {
 };
 
 const ACTION_COLOR: Record<string, string> = {
-  created: "bg-blue-500",
-  validated: "bg-amber-500",
-  deployed: "bg-emerald-500",
-  rejected: "bg-red-500",
-  rolled_back: "bg-red-400",
+  created: "bg-primary/15",
+  validated: "bg-primary/25",
+  deployed: "bg-primary/30",
+  rejected: "bg-destructive/20",
+  rolled_back: "bg-destructive/15",
+};
+
+const ACTION_ICON_COLOR: Record<string, string> = {
+  created: "text-primary/70",
+  validated: "text-primary/85",
+  deployed: "text-primary",
+  rejected: "text-destructive",
+  rolled_back: "text-destructive/70",
 };
 
 const ACTION_RING: Record<string, string> = {
-  created: "ring-blue-500/30",
-  validated: "ring-amber-500/30",
-  deployed: "ring-emerald-500/30",
-  rejected: "ring-red-500/30",
-  rolled_back: "ring-red-400/30",
+  created: "ring-primary/15",
+  validated: "ring-primary/25",
+  deployed: "ring-primary/30",
+  rejected: "ring-destructive/25",
+  rolled_back: "ring-destructive/15",
+};
+
+const ACTION_DOT: Record<string, string> = {
+  created: "bg-primary/40 ring-primary/30",
+  validated: "bg-primary/60 ring-primary/40",
+  deployed: "bg-primary ring-primary/50",
+  rejected: "bg-destructive/60 ring-destructive/40",
+  rolled_back: "bg-destructive/40 ring-destructive/30",
 };
 
 const ACTION_LINE: Record<string, string> = {
-  created: "bg-blue-500/30",
-  validated: "bg-amber-500/30",
-  deployed: "bg-emerald-500/30",
-  rejected: "bg-red-500/30",
-  rolled_back: "bg-red-400/30",
+  created: "bg-primary/15",
+  validated: "bg-primary/20",
+  deployed: "bg-primary/25",
+  rejected: "bg-destructive/20",
+  rolled_back: "bg-destructive/15",
 };
 
 interface Props {
@@ -93,7 +109,7 @@ function PassRateDelta({ snapshot }: { snapshot: EvalSnapshot }) {
     <span
       className={cn(
         "inline-flex items-center gap-0.5 text-[10px] font-mono font-medium",
-        isPositive ? "text-emerald-600 dark:text-emerald-400" : "text-red-500",
+        isPositive ? "text-primary" : "text-destructive",
       )}
     >
       {isPositive ? (
@@ -119,23 +135,35 @@ function LifecycleLegend() {
   const [open, setOpen] = useState(false);
 
   return (
-    <div className="px-2 pb-2">
+    <div className="px-2 pb-3">
       <button
         type="button"
         onClick={() => setOpen(!open)}
-        className="flex items-center gap-1 text-[10px] text-muted-foreground/70 hover:text-muted-foreground transition-colors w-full"
+        aria-expanded={open}
+        aria-controls="evolution-lifecycle-stages"
+        className="flex w-full items-center gap-1 text-[10px] text-muted-foreground/70 transition-colors hover:text-muted-foreground"
       >
         {open ? <ChevronDownIcon className="size-3" /> : <ChevronRightIcon className="size-3" />}
         Lifecycle stages
       </button>
       {open && (
-        <div className="mt-1.5 space-y-1.5 rounded-md border bg-muted/30 p-2">
+        <div
+          id="evolution-lifecycle-stages"
+          className="mt-1.5 space-y-2.5 rounded-md border bg-muted/30 p-2"
+        >
           {LIFECYCLE_STEPS.map((step) => (
             <div key={step.action} className="flex items-start gap-2">
-              <div className={cn("size-2 rounded-full mt-1 shrink-0", ACTION_COLOR[step.action])} />
-              <div className="min-w-0">
-                <span className="text-[10px] font-medium">{step.label}</span>
-                <p className="text-[10px] text-muted-foreground/70 leading-tight">{step.desc}</p>
+              <div
+                className={cn(
+                  "size-2 rounded-full shrink-0 ring-1 mt-[3px]",
+                  ACTION_DOT[step.action],
+                )}
+              />
+              <div className="min-w-0 flex flex-col gap-0.5">
+                <span className="text-[10px] font-medium leading-none">{step.label}</span>
+                <span className="text-[10px] text-muted-foreground/70 leading-tight">
+                  {step.desc}
+                </span>
               </div>
             </div>
           ))}
@@ -158,7 +186,7 @@ export function EvolutionTimeline({ entries, selectedProposalId, onSelect }: Pro
 
   return (
     <div className="flex flex-col gap-0">
-      <h2 className="text-xs font-semibold text-muted-foreground uppercase tracking-wider px-2 pb-2 sticky top-0 z-10 bg-background">
+      <h2 className="px-2 pb-2 text-[10px] font-semibold uppercase tracking-[0.18em] text-muted-foreground/80">
         Evolution
       </h2>
       <LifecycleLegend />
@@ -167,7 +195,8 @@ export function EvolutionTimeline({ entries, selectedProposalId, onSelect }: Pro
           const terminal = terminalAction(steps);
           const isSelected = selectedProposalId === proposalId;
           const lastStep = steps[steps.length - 1];
-          const dotColor = ACTION_COLOR[terminal] ?? "bg-muted-foreground";
+          const dotColor = ACTION_COLOR[terminal] ?? "bg-muted-foreground/20";
+          const iconColor = ACTION_ICON_COLOR[terminal] ?? "text-muted-foreground";
           const ringColor = ACTION_RING[terminal] ?? "ring-muted-foreground/30";
           const lineColor = ACTION_LINE[terminal] ?? "bg-border";
           const isLast = groupIdx === groups.length - 1;
@@ -179,14 +208,15 @@ export function EvolutionTimeline({ entries, selectedProposalId, onSelect }: Pro
               <div className="flex flex-col items-center">
                 <div
                   className={cn(
-                    "flex items-center justify-center size-7 rounded-full ring-2 text-white shrink-0 z-10",
+                    "flex items-center justify-center size-7 rounded-full ring-2 shrink-0 z-10",
                     dotColor,
                     ringColor,
+                    iconColor,
                   )}
                 >
                   {ACTION_ICON[terminal] ?? <CircleDotIcon className="size-3.5" />}
                 </div>
-                {!isLast && <div className={cn("w-0.5 flex-1 min-h-[16px]", lineColor)} />}
+                {!isLast && <div className={cn("w-0.5 flex-1 min-h-[8px] my-1", lineColor)} />}
               </div>
 
               {/* Content */}
@@ -241,7 +271,7 @@ export function EvolutionTimeline({ entries, selectedProposalId, onSelect }: Pro
                           key={`${s.action}-${i}`}
                           className={cn(
                             "size-1.5 rounded-full",
-                            ACTION_COLOR[s.action] ?? "bg-muted-foreground",
+                            ACTION_DOT[s.action] ?? "bg-muted-foreground/40",
                           )}
                         />
                       ))}

package/packages/ui/src/components/OrchestrateRunsPanel.tsx

@@ -8,7 +8,7 @@ import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../primitiv
 import type { OrchestrateRunReport, OrchestrateRunSkillAction } from "../types";
 
 const ACTION_ICON: Record<string, React.ReactNode> = {
-  evolve: <ZapIcon className="size-3 text-amber-500" />,
+  evolve: <ZapIcon className="size-3 text-primary-accent" />,
   watch: <EyeIcon className="size-3 text-blue-500" />,
   skip: <SkipForwardIcon className="size-3 text-muted-foreground" />,
 };
@@ -66,17 +66,15 @@ function RunCard({ run }: { run: OrchestrateRunReport }) {
           <div
             className={`mt-1.5 size-2 shrink-0 rounded-full ${
               run.deployed > 0
-                ? "bg-emerald-500"
+                ? "bg-primary"
                 : run.evolved > 0
-                  ? "bg-amber-400"
+                  ? "bg-primary-accent"
                   : "bg-muted-foreground/40"
             }`}
           />
           <div className="flex-1 min-w-0">
             <div className="flex items-center gap-2">
-              <span className="text-xs font-mono text-muted-foreground">
-                {timeAgo(run.timestamp)}
-              </span>
+              <span className="text-[10px] font-mono text-slate-500">{timeAgo(run.timestamp)}</span>
               {run.dry_run && (
                 <Badge variant="outline" className="text-[10px] h-4 px-1.5">
                   dry-run
@@ -90,7 +88,7 @@ function RunCard({ run }: { run: OrchestrateRunReport }) {
             </div>
             <div className="flex items-center gap-3 mt-1 text-xs text-muted-foreground">
               {run.deployed > 0 && (
-                <span className="text-emerald-600 font-medium">{run.deployed} deployed</span>
+                <span className="text-primary font-medium">{run.deployed} deployed</span>
               )}
               {run.evolved > 0 && <span>{run.evolved} evolved</span>}
               {run.watched > 0 && <span>{run.watched} watched</span>}
@@ -104,7 +102,7 @@ function RunCard({ run }: { run: OrchestrateRunReport }) {
         </div>
       </CollapsibleTrigger>
       <CollapsibleContent>
-        <div className="ml-5 pl-3 border-l border-border space-y-0.5 pb-2">
+        <div className="ml-5 pl-3 border-l border-border/15 space-y-0.5 pb-2">
           {nonSkipActions.map((action, i) => (
             <SkillActionRow key={`${action.skill}-${i}`} action={action} />
           ))}
@@ -126,7 +124,32 @@ function RunCard({ run }: { run: OrchestrateRunReport }) {
   );
 }
 
-export function OrchestrateRunsPanel({ runs }: { runs: OrchestrateRunReport[] }) {
+export function OrchestrateRunsPanel({
+  runs,
+  embedded = false,
+}: {
+  runs: OrchestrateRunReport[];
+  embedded?: boolean;
+}) {
+  const totalDeployed = runs.reduce((sum, r) => sum + r.deployed, 0);
+  const content =
+    runs.length === 0 ? (
+      <p className="py-4 text-center text-sm text-muted-foreground">
+        No orchestrate runs yet. Run{" "}
+        <code className="rounded bg-muted px-1 py-0.5 text-xs">selftune orchestrate</code> to start.
+      </p>
+    ) : (
+      <div className="space-y-0">
+        {runs.slice(0, 10).map((run) => (
+          <RunCard key={run.run_id} run={run} />
+        ))}
+      </div>
+    );
+
+  if (embedded) {
+    return <div>{content}</div>;
+  }
+
   if (runs.length === 0) {
     return (
       <Card>
@@ -147,8 +170,6 @@ export function OrchestrateRunsPanel({ runs }: { runs: OrchestrateRunReport[] })
     );
   }
 
-  const totalDeployed = runs.reduce((sum, r) => sum + r.deployed, 0);
-
   return (
     <Card>
       <CardHeader>
@@ -161,11 +182,7 @@ export function OrchestrateRunsPanel({ runs }: { runs: OrchestrateRunReport[] })
           {totalDeployed > 0 && <> &middot; {totalDeployed} total deployments</>}
         </CardDescription>
       </CardHeader>
-      <CardContent className="space-y-0">
-        {runs.slice(0, 10).map((run) => (
-          <RunCard key={run.run_id} run={run} />
-        ))}
-      </CardContent>
+      <CardContent>{content}</CardContent>
     </Card>
   );
 }

package/packages/ui/src/components/RecentActivityFeed.tsx

@@ -13,7 +13,77 @@ export interface RecentActivityItem {
   is_live: boolean;
 }
 
-export function RecentActivityFeed({ items }: { items: RecentActivityItem[] }) {
+export function RecentActivityFeed({
+  items,
+  embedded = false,
+}: {
+  items: RecentActivityItem[];
+  embedded?: boolean;
+}) {
+  const content =
+    items.length === 0 ? (
+      <p className="py-6 text-center text-sm text-muted-foreground">No recent skill invocations</p>
+    ) : (
+      <div className="space-y-2.5">
+        {items.slice(0, 20).map((item, i) => (
+          <div
+            key={`${item.session_id}-${item.skill_name}-${i}`}
+            className="flex gap-3 rounded-md p-1.5"
+          >
+            <div
+              className={`mt-0.5 w-10 h-10 shrink-0 rounded-xl bg-input flex items-center justify-center`}
+            >
+              <div
+                className={`size-2 rounded-full ${
+                  item.triggered
+                    ? "bg-primary shadow-[0_0_8px_rgba(79,242,255,0.6)]"
+                    : "bg-muted-foreground/40"
+                }`}
+              />
+            </div>
+            <div className="flex-1 min-w-0 space-y-0.5">
+              <div className="flex flex-wrap items-center gap-2">
+                <span className="truncate font-bold text-sm">{item.skill_name}</span>
+                {item.is_live && (
+                  <Badge variant="outline" className="h-4 gap-1 px-1 text-[10px]">
+                    <CircleDotIcon className="size-2.5 text-primary" />
+                    live
+                  </Badge>
+                )}
+                {item.triggered ? (
+                  <Badge
+                    variant="default"
+                    className="h-4 px-1 text-[10px] font-bold uppercase tracking-tighter bg-primary/10 text-primary"
+                  >
+                    triggered
+                  </Badge>
+                ) : (
+                  <Badge
+                    variant="secondary"
+                    className="h-4 px-1 text-[10px] font-bold uppercase tracking-tighter"
+                  >
+                    checked
+                  </Badge>
+                )}
+                <span className="ml-auto shrink-0 font-mono text-[10px] text-slate-500">
+                  {timeAgo(item.timestamp)}
+                </span>
+              </div>
+              {item.query && (
+                <p className="line-clamp-1 text-sm text-card-foreground leading-relaxed">
+                  {item.query}
+                </p>
+              )}
+            </div>
+          </div>
+        ))}
+      </div>
+    );
+
+  if (embedded) {
+    return <div>{content}</div>;
+  }
+
   if (items.length === 0) {
     return (
       <Card>
@@ -41,46 +111,7 @@ export function RecentActivityFeed({ items }: { items: RecentActivityItem[] }) {
         </CardTitle>
         <CardDescription>Latest skill invocations across sessions</CardDescription>
       </CardHeader>
-      <CardContent className="space-y-2.5">
-        {items.slice(0, 20).map((item, i) => (
-          <div
-            key={`${item.session_id}-${item.skill_name}-${i}`}
-            className="flex gap-3 rounded-md p-1.5"
-          >
-            <div
-              className={`mt-1 size-2 shrink-0 rounded-full ${
-                item.triggered ? "bg-emerald-500" : "bg-muted-foreground/40"
-              }`}
-            />
-            <div className="flex-1 min-w-0 space-y-0.5">
-              <div className="flex items-center gap-2 flex-wrap">
-                <span className="text-xs font-medium truncate">{item.skill_name}</span>
-                {item.is_live && (
-                  <Badge variant="outline" className="h-4 px-1 text-[10px] gap-1">
-                    <CircleDotIcon className="size-2.5 text-emerald-500" />
-                    live
-                  </Badge>
-                )}
-                {item.triggered ? (
-                  <Badge variant="default" className="h-4 px-1 text-[10px]">
-                    triggered
-                  </Badge>
-                ) : (
-                  <Badge variant="secondary" className="h-4 px-1 text-[10px]">
-                    checked
-                  </Badge>
-                )}
-                <span className="text-[10px] text-muted-foreground font-mono ml-auto shrink-0">
-                  {timeAgo(item.timestamp)}
-                </span>
-              </div>
-              {item.query && (
-                <p className="text-xs text-muted-foreground line-clamp-1 font-mono">{item.query}</p>
-              )}
-            </div>
-          </div>
-        ))}
-      </CardContent>
+      <CardContent>{content}</CardContent>
     </Card>
   );
 }

package/packages/ui/src/components/section-cards.tsx

@@ -24,6 +24,9 @@ interface SectionCardsProps {
   activeSessionsCount?: number;
 }
 
+const CARD_DESCRIPTION_CLASS =
+  "flex items-center gap-1.5 text-[10px] uppercase tracking-widest text-slate-500";
+
 export function SectionCards({
   skillsCount,
   avgPassRate,
@@ -38,10 +41,10 @@ export function SectionCards({
   const passRateGood = avgPassRate !== null && avgPassRate >= 0.7;
 
   return (
-    <div className="grid grid-cols-1 gap-4 px-4 *:data-[slot=card]:shadow-xs lg:px-6 @xl/main:grid-cols-2 @5xl/main:grid-cols-3">
+    <div className="grid grid-cols-1 gap-4 px-4 *:data-[slot=card]:shadow-none lg:px-6 @xl/main:grid-cols-2 @5xl/main:grid-cols-3">
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <LayersIcon className="size-3.5" />
             Skills Monitored
             <InfoTip text="Total number of skills detected and being tracked by selftune" />
@@ -60,7 +63,7 @@ export function SectionCards({
 
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <FlaskConicalIcon className="size-3.5" />
             Avg Trigger Rate
             <InfoTip text="Average percentage of skill checks that resulted in a trigger across all graded skills (5+ checks). Run selftune evolve to improve this." />
@@ -91,7 +94,7 @@ export function SectionCards({
 
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <SearchXIcon className="size-3.5" />
             Unmatched Queries
             <InfoTip text="User prompts that didn't match any skill's trigger criteria — potential gaps in coverage" />
@@ -112,7 +115,7 @@ export function SectionCards({
 
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <ActivityIcon className="size-3.5" />
             Sessions
             <InfoTip text="Total agent sessions that have been recorded and analyzed" />
@@ -124,8 +127,8 @@ export function SectionCards({
             <CardAction>
               <Badge variant="outline" className="gap-1.5">
                 <span className="relative flex size-2">
-                  <span className="absolute inline-flex size-full animate-ping rounded-full bg-emerald-400 opacity-75" />
-                  <span className="relative inline-flex size-2 rounded-full bg-emerald-500" />
+                  <span className="absolute inline-flex size-full animate-ping rounded-full bg-primary opacity-75" />
+                  <span className="relative inline-flex size-2 rounded-full bg-primary shadow-[0_0_8px_color-mix(in_srgb,var(--primary)_60%,transparent)]" />
                 </span>
                 {activeSessionsCount} in progress
               </Badge>
@@ -136,7 +139,7 @@ export function SectionCards({
 
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <AlertTriangleIcon className="size-3.5" />
             Undeployed Proposals
             <InfoTip text="Evolution proposals that have been generated but not yet validated or deployed. Requires running selftune evolve." />
@@ -158,7 +161,7 @@ export function SectionCards({
 
       <Card className="@container/card">
         <CardHeader>
-          <CardDescription className="flex items-center gap-1.5">
+          <CardDescription className={CARD_DESCRIPTION_CLASS}>
             <EyeIcon className="size-3.5" />
             Total Evidence
             <InfoTip text="Number of evidence entries documenting skill changes with before/after validation results. Requires running selftune evolve." />

package/packages/ui/src/primitives/card.tsx

@@ -12,7 +12,7 @@ function Card({
       data-slot="card"
       data-size={size}
       className={cn(
-        "group/card flex flex-col gap-4 overflow-hidden rounded-xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/10 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
+        "group/card flex flex-col gap-4 overflow-hidden rounded-2xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/5 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
         className,
       )}
       {...props}

package/skill/SKILL.md

@@ -89,6 +89,7 @@ selftune eval generate      --skill <name> [--list-skills] [--stats] [--max N] [
 selftune eval unit-test      --skill <name> --tests <path> [--run-agent] [--generate]
 selftune eval import         --dir <path> --skill <name> --output <path> [--match-strategy exact|fuzzy]
 selftune eval composability  --skill <name> [--window N] [--telemetry-log <path>]
+selftune eval family-overlap --prefix <family-> | --skills <a,b,c> [--parent-skill <name>] [--min-overlap 0.3] [--min-shared 2]
 
 # Other commands
 selftune watch    --skill <name> --skill-path <path> [--auto-rollback]
@@ -96,6 +97,8 @@ selftune status
 selftune last
 selftune doctor
 selftune dashboard [--port <port>] [--no-open]
+selftune contributions [status|preview <skill>|upload [--dry-run]|approve <skill>|revoke <skill>|default <ask|always|never>|reset]
+selftune creator-contributions [status|enable --skill <name>|enable --all [--prefix <value>]|disable --skill <name>]
 selftune contribute [--skill NAME] [--preview] [--sanitize LEVEL] [--submit]
 selftune cron setup [--dry-run]                         # auto-detect platform (cron/launchd/systemd)
 selftune cron setup --platform openclaw [--dry-run] [--tz <timezone>]  # OpenClaw-specific
@@ -115,6 +118,7 @@ selftune badge       --skill <name> [--format svg|markdown|url] [--output PATH]
 # Maintenance
 selftune quickstart
 selftune repair-skill-usage [--since DATE] [--dry-run]
+selftune recover            [--full] [--force] [--since DATE]
 selftune export-canonical   [--out FILE] [--platform NAME] [--record-kind KIND] [--pretty] [--push-payload]
 selftune uninstall          [--dry-run] [--keep-logs] [--npm-uninstall]
 
@@ -141,6 +145,8 @@ selftune status                                                        # shows c
 | doctor, health, hooks, broken, diagnose, not working, something wrong                                                                   | Doctor            | Workflows/Doctor.md                   |
 | ingest, import, codex logs, opencode, openclaw, wrap codex                                                                              | Ingest            | Workflows/Ingest.md                   |
 | replay, backfill, claude transcripts, historical sessions                                                                               | Replay            | Workflows/Replay.md                   |
+| contributions, sharing preferences, opt in creator sharing, opt out creator sharing, approve contributions, revoke contributions, preview contributions, upload contributions, relay queue, contribution upload, contribution preview        | Contributions     | Workflows/Contributions.md            |
+| creator contributions, bundle contribution config, selftune.contribute.json, enable creator contribution, disable creator contribution, bulk enable creator contribution, enable all creator contributions, creator prefix config, --all, --prefix  | CreatorContributions | Workflows/CreatorContributions.md  |
 | contribute, share, community, export data, anonymized, give back                                                                        | Contribute        | Workflows/Contribute.md               |
 | init, setup, set up, bootstrap, first time, install, configure selftune, alpha, enroll, alpha enrollment, cloud link, upload credential | Initialize        | Workflows/Initialize.md               |
 | cron, schedule, automate evolution, run automatically                                                                                   | Cron              | Workflows/Cron.md                     |
@@ -149,7 +155,7 @@ selftune status                                                        # shows c
 | evolution memory, session continuity, what happened last                                                                                | EvolutionMemory   | Workflows/EvolutionMemory.md          |
 | grade baseline, baseline lift, adds value, skill value, no-skill comparison                                                             | Baseline          | Workflows/Baseline.md                 |
 | eval unit-test, skill test, test skill, generate tests, run tests                                                                       | UnitTest          | Workflows/UnitTest.md                 |
-| eval composability, co-occurrence, skill conflicts, skills together                                                                     | Composability     | Workflows/Composability.md            |
+| eval composability, co-occurrence, skill conflicts, skills together, family overlap, sibling confusion, consolidate skill family      | Composability     | Workflows/Composability.md            |
 | eval import, skillsbench, external evals, benchmark tasks                                                                               | ImportSkillsBench | Workflows/ImportSkillsBench.md        |
 | telemetry, analytics, disable analytics, opt out, tracking, privacy                                                                     | Telemetry         | Workflows/Telemetry.md                |
 | orchestrate, autonomous, full loop, improve all skills, run selftune loop                                                               | Orchestrate       | Workflows/Orchestrate.md              |
@@ -157,6 +163,7 @@ selftune status                                                        # shows c
 | badge, readme badge, skill badge, health badge                                                                                          | Badge             | Workflows/Badge.md                    |
 | workflows, discover workflows, list workflows, multi-skill workflows                                                                    | Workflows         | Workflows/Workflows.md                |
 | alpha upload, upload data, send alpha data, manual upload, dry run upload                                                               | AlphaUpload       | Workflows/AlphaUpload.md              |
+| recover, rebuild sqlite, recover db, legacy backfill, restore from export snapshot                                                      | Recover           | Workflows/Recover.md                  |
 | quickstart, getting started, onboard, first time setup, new user                                                                        | Quickstart        | Workflows/Quickstart.md               |
 | uninstall, remove selftune, clean up, teardown                                                                                          | Uninstall         | Workflows/Uninstall.md                |
 | repair, rebuild usage, fix skill usage, trustworthy usage, repair-skill-usage                                                           | RepairSkillUsage  | Workflows/RepairSkillUsage.md         |
@@ -345,6 +352,9 @@ accomplish a task _using_ a skill, route to that skill instead.
 | `Workflows/Quickstart.md`           | Guided onboarding: init, ingest, status             | First-time setup for new users                  |
 | `Workflows/Uninstall.md`            | Clean removal of selftune data and config           | When removing selftune completely               |
 | `Workflows/RepairSkillUsage.md`     | Rebuild skill usage from source transcripts         | When skill usage data seems inaccurate          |
+| `Workflows/Recover.md`              | Recover SQLite from legacy/exported JSONL           | When rebuilding or backfilling SQLite           |
+| `Workflows/Contributions.md`        | Manage creator-directed sharing preferences         | When approving or revoking creator contribution |
+| `Workflows/CreatorContributions.md` | Manage bundled `selftune.contribute.json` configs   | When preparing a skill package for creator contributions |
 | `Workflows/ExportCanonical.md`      | Export canonical telemetry for downstream use       | When exporting data for external consumption    |
 | `Workflows/Hook.md`                 | Manual hook invocation for debugging                | When debugging or testing hooks manually        |
 | `references/logs.md`                | Log file formats (telemetry, usage, queries, audit) | When parsing or debugging log files             |

package/skill/Workflows/AlphaUpload.md

@@ -24,6 +24,10 @@ selftune alpha upload [--dry-run]
 4. Build V2 push envelopes and flush them to the cloud API
 5. Print a JSON summary with `enrolled`, `prepared`, `sent`, `failed`, `skipped`, and optional `guidance`
 
+`selftune sync` already triggers an upload cycle automatically when alpha is
+enrolled. Use this workflow when you want a manual upload now or want to see a
+dry-run summary of what SQLite-backed staging would send.
+
 ## Examples
 
 Preview the upload:

package/skill/Workflows/Composability.md

@@ -4,12 +4,27 @@ Analyze how skills interact when triggered together in the same session.
 Detects conflict candidates — skill pairs that produce more errors when
 co-occurring than when used alone.
 
+Use the same workflow when the user is asking whether a sibling skill family
+should stay split apart or be consolidated under one parent skill.
+
 ## Default Command
 
 ```bash
 selftune eval composability --skill <name> [options]
 ```
 
+## Family Overlap Command
+
+```bash
+selftune eval family-overlap --prefix <family-> [options]
+```
+
+Or analyze an explicit set of siblings:
+
+```bash
+selftune eval family-overlap --skills <skill-a,skill-b,skill-c> [options]
+```
+
 ## Options
 
 | Flag                     | Description                            | Default                                 |
@@ -18,6 +33,16 @@ selftune eval composability --skill <name> [options]
 | `--window <n>`           | Only analyze sessions from last N days | All sessions                            |
 | `--telemetry-log <path>` | Path to telemetry log                  | `~/.claude/session_telemetry_log.jsonl` |
 
+### Family Overlap Options
+
+| Flag                    | Description                                                        | Default |
+| ----------------------- | ------------------------------------------------------------------ | ------- |
+| `--prefix <family->`    | Analyze all installed/observed sibling skills with this prefix     | Required unless `--skills` |
+| `--skills <a,b,c>`      | Analyze a specific skill family                                    | Required unless `--prefix` |
+| `--parent-skill <name>` | Override the suggested consolidated parent skill name              | Derived from prefix |
+| `--min-overlap <pct>`   | Minimum positive-query overlap to flag consolidation pressure      | `0.3` |
+| `--min-shared <n>`      | Minimum shared positive queries to flag a sibling pair             | `2` |
+
 ## Output Format
 
 ```json
@@ -60,6 +85,25 @@ The analyzer is a pure function that computes conflict scores from telemetry:
 3. Pairs with `conflict_score > 0.3` are flagged as conflict candidates
 4. Results sorted by co-occurrence count (most common first)
 
+## How Family Overlap Works
+
+The family-overlap analyzer answers a different question:
+
+1. Build a trusted positive query set for each sibling skill
+2. Compare every pair of siblings using exact-query overlap
+3. Flag pairs whose overlap crosses the configured threshold
+4. If overlap is persistent across the family, emit:
+   - consolidation recommendation
+   - draft parent skill name
+   - internal workflow mapping
+   - compatibility alias / migration notes
+
+This is for packaging questions like:
+
+- "Should `sc-search`, `sc-model`, and `sc-compare` really be one parent skill?"
+- "Are my sibling skills competing for the same user intent?"
+- "Should I stop evolving these independently and redesign the family?"
+
 ## Steps
 
 ### 1. Run Analysis
@@ -86,6 +130,18 @@ When conflict candidates are identified, present them to the user with recommend
 - Consider evolving descriptions to reduce false triggers
 - Use the `pattern-analyst` agent for deeper cross-skill analysis
 
+### 4. Investigate Family Consolidation
+
+```bash
+selftune eval family-overlap --prefix sc-
+```
+
+Interpretation:
+
+- `consolidation_candidate: false` means keep improving the sibling descriptions/workflows separately
+- `consolidation_candidate: true` means the problem is likely packaging, not just wording
+- `refactor_proposal` is a draft for human review only; do not auto-deploy a family rewrite
+
 ## Subagent Escalation
 
 For deep cross-skill analysis beyond what the composability command provides,
@@ -110,3 +166,11 @@ resolution plan with trigger ownership recommendations.
 **"Why are sessions with multiple skills failing?"**
 
 > Run composability for each skill involved, look for high conflict scores.
+
+**"Are my State Change skills too fragmented?"**
+
+> `selftune eval family-overlap --prefix sc-`
+
+**"Should I consolidate this sibling skill family?"**
+
+> Run `selftune eval family-overlap` and look for `consolidation_candidate` plus the `refactor_proposal`.