Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(desktop): brand built-in skill creator

xd-bobo142f28a4836e
diff --git a/apps/desktop/help-knowledge/skills.md b/apps/desktop/help-knowledge/skills.md
index 6d89ea72ef..7f00fcb972 100644
--- a/apps/desktop/help-knowledge/skills.md
+++ b/apps/desktop/help-knowledge/skills.md
@@ -30,10 +30,10 @@ Skills are reusable agent capabilities you package as a folder and load into you
**Creating a Skill from the composer:**
-- Cindy includes `/skill-creator`. Invoke it with a description of the Skill you want, such as `/skill-creator Create a Skill that checks release notes`. Invoking it without a description asks what you want to create.
+- Cindy includes `/cindy-skill-creator`. Invoke it with a description of the Skill you want, such as `/cindy-skill-creator Create a Skill that checks release notes`. Invoking it without a description asks what you want to create.
- The current Agent creates or updates the Skill directly with its normal file tools. It does not use the `/learn` staging flow.
- Unless you request another location, new Skills go to `~/.agents/skills/<name>/`. Ask for a project-specific Skill to create it under `<working-dir>/.agents/skills/<name>/`.
-- The built-in `skill-creator` appears in the local Skill list. You can disable or enable it there; because it ships with Cindy, it cannot be uninstalled. The setting applies to new or restarted Agent sessions.
+- The built-in `cindy-skill-creator` appears in the local Skill list. You can disable or enable it there; because it ships with Cindy, it cannot be uninstalled. The setting applies to new or restarted Agent sessions.
**Disabling or uninstalling a local skill (Desktop):**
diff --git a/apps/desktop/resources/system-skills/README.md b/apps/desktop/resources/system-skills/README.md
index b5dba0b35b..75428a2468 100644
--- a/apps/desktop/resources/system-skills/README.md
+++ b/apps/desktop/resources/system-skills/README.md
@@ -1,8 +1,8 @@
# Bundled system Skills
-`skill-creator` is adapted from OpenAI Codex commit `977193486dfe7a88c4dab24abeafe9b754f5b13f`:
+`cindy-skill-creator` is adapted from OpenAI Codex commit `977193486dfe7a88c4dab24abeafe9b754f5b13f`:
- Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
-- License: Apache-2.0 (preserved in `skill-creator/license.txt`)
+- License: Apache-2.0 (preserved in `cindy-skill-creator/license.txt`)
Cindy materializes these resources into its user-data directory at startup. Do not put user-authored Skills here.
diff --git a/apps/desktop/resources/system-skills/skill-creator/SKILL.md b/apps/desktop/resources/system-skills/cindy-skill-creator/SKILL.md
similarity index 99%
rename from apps/desktop/resources/system-skills/skill-creator/SKILL.md
rename to apps/desktop/resources/system-skills/cindy-skill-creator/SKILL.md
index 90f94eac93..d719ad3ebe 100644
--- a/apps/desktop/resources/system-skills/skill-creator/SKILL.md
+++ b/apps/desktop/resources/system-skills/cindy-skill-creator/SKILL.md
@@ -1,5 +1,5 @@
---
-name: skill-creator
+name: cindy-skill-creator
description: Create or update a Cindy Skill with appropriately scoped instructions and any needed supporting resources.
metadata:
short-description: Create or update a skill
diff --git a/apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml b/apps/desktop/resources/system-skills/cindy-skill-creator/agents/openai.yaml
similarity index 80%
rename from apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml
rename to apps/desktop/resources/system-skills/cindy-skill-creator/agents/openai.yaml
index 1448cfa73a..b8e2066494 100644
--- a/apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml
+++ b/apps/desktop/resources/system-skills/cindy-skill-creator/agents/openai.yaml
@@ -1,5 +1,5 @@
interface:
- display_name: "Skill Creator"
+ display_name: "Cindy Skill Creator"
short_description: "Create or update a Cindy Skill"
icon_small: "./assets/skill-creator-small.svg"
icon_large: "./assets/skill-creator.png"
diff --git a/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator-small.svg b/apps/desktop/resources/system-skills/cindy-skill-creator/assets/skill-creator-small.svg
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/assets/skill-creator-small.svg
rename to apps/desktop/resources/system-skills/cindy-skill-creator/assets/skill-creator-small.svg
diff --git a/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator.png b/apps/desktop/resources/system-skills/cindy-skill-creator/assets/skill-creator.png
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/assets/skill-creator.png
rename to apps/desktop/resources/system-skills/cindy-skill-creator/assets/skill-creator.png
diff --git a/apps/desktop/resources/system-skills/skill-creator/license.txt b/apps/desktop/resources/system-skills/cindy-skill-creator/license.txt
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/license.txt
rename to apps/desktop/resources/system-skills/cindy-skill-creator/license.txt
diff --git a/apps/desktop/resources/system-skills/skill-creator/references/openai_yaml.md b/apps/desktop/resources/system-skills/cindy-skill-creator/references/openai_yaml.md
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/references/openai_yaml.md
rename to apps/desktop/resources/system-skills/cindy-skill-creator/references/openai_yaml.md
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/generate_openai_yaml.py b/apps/desktop/resources/system-skills/cindy-skill-creator/scripts/generate_openai_yaml.py
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/scripts/generate_openai_yaml.py
rename to apps/desktop/resources/system-skills/cindy-skill-creator/scripts/generate_openai_yaml.py
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/init_skill.py b/apps/desktop/resources/system-skills/cindy-skill-creator/scripts/init_skill.py
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/scripts/init_skill.py
rename to apps/desktop/resources/system-skills/cindy-skill-creator/scripts/init_skill.py
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/quick_validate.py b/apps/desktop/resources/system-skills/cindy-skill-creator/scripts/quick_validate.py
similarity index 100%
rename from apps/desktop/resources/system-skills/skill-creator/scripts/quick_validate.py
rename to apps/desktop/resources/system-skills/cindy-skill-creator/scripts/quick_validate.py
diff --git a/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts b/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts
index 98abf3bf3e..46a46fc09b 100644
--- a/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts
+++ b/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts
@@ -15,13 +15,13 @@ function fixture() {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-built-in-skills-'));
roots.push(root);
const bundledRoot = path.join(root, 'resources', 'system-skills');
- const source = path.join(bundledRoot, 'skill-creator');
+ const source = path.join(bundledRoot, 'cindy-skill-creator');
const userDataDir = path.join(root, 'user-data');
const homeDir = path.join(root, 'home');
fs.mkdirSync(path.join(source, 'scripts'), { recursive: true });
fs.writeFileSync(
path.join(source, 'SKILL.md'),
- '---\nname: skill-creator\ndescription: Create Skills\n---\n\n# Creator\n',
+ '---\nname: cindy-skill-creator\ndescription: Create Skills\n---\n\n# Creator\n',
);
fs.writeFileSync(path.join(source, 'scripts', 'validate.py'), 'print("ok")\n');
return { bundledRoot, source, userDataDir, homeDir };
@@ -36,7 +36,7 @@ describe('built-in Skills', () => {
const input = fixture();
const first = await prepareBuiltInSkills(input);
const descriptor = builtInSkillDescriptors(input.userDataDir)[0]!;
- const link = path.join(input.homeDir, '.agents', 'skills', 'skill-creator');
+ const link = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');
expect(first.changed).toBe(true);
expect(first.warnings).toEqual([]);
expect(fs.realpathSync(link)).toBe(fs.realpathSync(descriptor.absolutePath));
@@ -68,7 +68,7 @@ describe('built-in Skills', () => {
it('keeps a user-owned same-name Skill while retaining the Cindy copy', async () => {
const input = fixture();
- const userSkill = path.join(input.homeDir, '.agents', 'skills', 'skill-creator');
+ const userSkill = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');
fs.mkdirSync(userSkill, { recursive: true });
fs.writeFileSync(path.join(userSkill, 'SKILL.md'), '# User copy\n');
@@ -78,6 +78,37 @@ describe('built-in Skills', () => {
expect(result.warnings.join('\n')).toContain('already owned by the user');
});
+ it('repoints a shared link owned by another Cindy profile', async () => {
+ const input = fixture();
+ const first = await prepareBuiltInSkills(input);
+ const oldDescriptor = first.descriptors[0]!;
+ const link = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');
+ const nextUserDataDir = path.join(path.dirname(input.userDataDir), 'next-user-data');
+
+ const next = await prepareBuiltInSkills({ ...input, userDataDir: nextUserDataDir });
+ const nextDescriptor = next.descriptors[0]!;
+
+ expect(next.warnings).toEqual([]);
+ expect(next.changed).toBe(true);
+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(nextDescriptor.absolutePath));
+ expect(fs.existsSync(path.join(oldDescriptor.absolutePath, 'SKILL.md'))).toBe(true);
+ });
+
+ it('keeps a user-owned same-name symlink', async () => {
+ const input = fixture();
+ const userSource = path.join(path.dirname(input.homeDir), 'user-skill');
+ const userSkill = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');
+ fs.mkdirSync(userSource, { recursive: true });
+ fs.mkdirSync(path.dirname(userSkill), { recursive: true });
+ fs.writeFileSync(path.join(userSource, 'SKILL.md'), '# User symlink copy\n');
+ fs.symlinkSync(userSource, userSkill, process.platform === 'win32' ? 'junction' : 'dir');
+
+ const result = await prepareBuiltInSkills(input);
+
+ expect(fs.realpathSync(userSkill)).toBe(fs.realpathSync(userSource));
+ expect(result.warnings.join('\n')).toContain('already owned by the user');
+ });
+
it('keeps a user-owned Skill in the isolated Claude config directory', async () => {
const input = fixture();
const descriptor = builtInSkillDescriptors(input.userDataDir)[0]!;
diff --git a/apps/desktop/src/main/maker-host/built-in-skills.ts b/apps/desktop/src/main/maker-host/built-in-skills.ts
index 75ff9d93dd..921a16ec2e 100644
--- a/apps/desktop/src/main/maker-host/built-in-skills.ts
+++ b/apps/desktop/src/main/maker-host/built-in-skills.ts
@@ -3,9 +3,10 @@ import fs from 'node:fs';
import { promises as fsp } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
+import { CINDY_SKILL_CREATOR_NAME } from '../../shared/cindyBuiltInSkills';
import { atomicWriteFileSync } from '../utils/atomicWriteFile';
-export const BUILT_IN_SKILL_CREATOR_NAME = 'skill-creator';
+export const BUILT_IN_SKILL_CREATOR_NAME = CINDY_SKILL_CREATOR_NAME;
const BUILT_IN_SKILL_NAMES = [BUILT_IN_SKILL_CREATOR_NAME] as const;
const MANIFEST_FILE = '.cindy-system-skills.json';
@@ -14,7 +15,6 @@ export interface BuiltInSkillDescriptor {
name: string;
absolutePath: string;
nativeClaudePath: string;
- nativeCodexPath: string;
}
export interface PrepareBuiltInSkillsOptions {
@@ -54,7 +54,6 @@ export function builtInSkillDescriptors(userDataDir: string): BuiltInSkillDescri
name,
absolutePath: path.join(root, name),
nativeClaudePath: path.join(userDataDir, 'claude-home', 'skills', name),
- nativeCodexPath: path.join(userDataDir, 'codex-home', 'skills', '.system', name),
}));
}
@@ -139,6 +138,7 @@ async function materializeSkill(
async function ensureSkillEntry(
descriptor: BuiltInSkillDescriptor,
linkPath: string,
+ replaceStaleCindyLink = false,
): Promise<{ changed: boolean; warning?: string }> {
await fsp.mkdir(path.dirname(linkPath), { recursive: true });
@@ -151,7 +151,20 @@ async function ensureSkillEntry(
}
try {
- await fsp.lstat(linkPath);
+ const stat = await fsp.lstat(linkPath);
+ if (
+ replaceStaleCindyLink &&
+ stat.isSymbolicLink() &&
+ await isCindyManagedSystemSkillTarget(linkPath, descriptor.name)
+ ) {
+ await fsp.unlink(linkPath);
+ await fsp.symlink(
+ descriptor.absolutePath,
+ linkPath,
+ process.platform === 'win32' ? 'junction' : 'dir',
+ );
+ return { changed: true };
+ }
return {
changed: false,
warning: `built-in Skill ${descriptor.name} was not linked because ${linkPath} is already owned by the user`,
@@ -168,6 +181,26 @@ async function ensureSkillEntry(
return { changed: true };
}
+async function isCindyManagedSystemSkillTarget(
+ linkPath: string,
+ skillName: string,
+): Promise<boolean> {
+ try {
+ const target = await fsp.realpath(linkPath);
+ const targetRoot = path.dirname(target);
+ if (path.basename(target) !== skillName || path.basename(targetRoot) !== 'system-skills') {
+ return false;
+ }
+ const parsed = JSON.parse(
+ await fsp.readFile(path.join(targetRoot, MANIFEST_FILE), 'utf8'),
+ ) as Partial<MaterializationManifest>;
+ return parsed.schemaVersion === 1 &&
+ typeof parsed.fingerprints?.[skillName] === 'string';
+ } catch {
+ return false;
+ }
+}
+
async function ensureSharedEntry(
descriptor: BuiltInSkillDescriptor,
homeDir: string,
@@ -175,6 +208,7 @@ async function ensureSharedEntry(
return ensureSkillEntry(
descriptor,
path.join(homeDir, '.agents', 'skills', descriptor.name),
+ true,
);
}
@@ -223,7 +257,7 @@ export async function prepareBuiltInSkills(
}
try {
- const linked = await ensureSkillEntry(descriptor, descriptor.nativeClaudePath);
+ const linked = await ensureSkillEntry(descriptor, descriptor.nativeClaudePath, true);
changed = linked.changed || changed;
if (linked.warning) warnings.push(linked.warning);
} catch (error) {
diff --git a/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts b/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
index e569c59d0a..ed927344b5 100644
--- a/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
+++ b/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
@@ -144,7 +144,7 @@ export const HELP_KNOWLEDGE: HelpKnowledgeDoc[] = [
id: "skills",
title: "Skills (reusable agent capabilities)",
summary: "Create, browse, install, disable, uninstall, publish, and update agent Skills; Skills appear as \"/\" slash commands and are shared across Claude Code, Codex, and Pi.",
- content: "Skills are reusable agent capabilities you package as a folder and load into your sessions. They're managed on the same page as Plugins — **Skills** and **Plugins** are two tabs of one management surface (the Skills tab is the in-app browser for finding, installing, publishing, and updating skills).\n\n**Skills work across local agents:**\n\n- Skills are **engine-shared** — the same installed Skill is available to Claude Code, Codex, and Pi, so you install it once.\n\n**Where skills live on disk:**\n\n- Global (available to every session): the shared root `~/.agents/skills/<name>/`, which is cross-linked to `~/.claude/skills/` and `~/.codex/skills/` so every engine sees the same skills. On Windows that's under `C:\\Users\\<you>\\`.\n- Project-scoped (only inside one working directory): `<working-dir>/.agents/skills/<name>/` or `<working-dir>/.claude/skills/<name>/`.\n- Each skill is its own folder with a required `SKILL.md` at the root (the prompt / spec the agent reads). Sibling files and subfolders in that folder are also visible to the agent.\n\n**Importing a local skill:**\n\n- On the Skills page, use **Import skill** (top-right) to pick a `.zip` package or a standalone `SKILL.md` file.\n- A zip must contain a `SKILL.md` (at the package root, or inside a single top-level folder). The YAML frontmatter must include non-empty `name` and `description` fields; `name` must match `^[a-z0-9-]{1,200}$`.\n- You then choose where to install: global, a known project, or another directory. Cindy extracts metadata from the file automatically and lists the skill with that name and description.\n- Imported skills can be uninstalled from the detail page, and you can publish them to SkillHub later if you want.\n\n**Using an installed skill:**\n\n- Hover over a local skill in the `/` suggestions and choose **View skill details** in its information panel to open that exact skill. This does not insert or send the command. Pi package skills remain usable from `/`, but do not show this local detail shortcut; manage them through their package.\n\n- Type `/` in the composer to open the slash-command palette; your installed skills show up there alongside built-in and agent commands. Pick one to run it.\n\n**Creating a Skill from the composer:**\n\n- Cindy includes `/skill-creator`. Invoke it with a description of the Skill you want, such as `/skill-creator Create a Skill that checks release notes`. Invoking it without a description asks what you want to create.\n- The current Agent creates or updates the Skill directly with its normal file tools. It does not use the `/learn` staging flow.\n- Unless you request another location, new Skills go to `~/.agents/skills/<name>/`. Ask for a project-specific Skill to create it under `<working-dir>/.agents/skills/<name>/`.\n- The built-in `skill-creator` appears in the local Skill list. You can disable or enable it there; because it ships with Cindy, it cannot be uninstalled. The setting applies to new or restarted Agent sessions.\n\n**Disabling or uninstalling a local skill (Desktop):**\n\n- Open a skill's detail page to use the switch in the top action bar. For a market skill installed in multiple locations, select the local copy from the location dropdown beside the switch. Turning it off keeps the files and removes the skill from new-task command previews. Active tasks retain the skill preference snapshot applied when their Agent started, including their command palette. New or restarted Claude Code, Codex, and Pi agents apply that choice; an already-running agent keeps its existing context.\n- Renaming a local skill while publishing keeps its enabled or disabled setting. If renaming fails, Cindy restores the original folder and content.\n- The switch is local to this device and Cindy profile. It does not edit external CLI settings, sync to other devices, or override a native engine's own disabled state. Enable it again to let the engine discover it normally.\n- In the skill's details, use **… → Uninstall skill**. Confirm the location and shared-file impact. Standalone skills, including locally written skills without a market installation record, move to the system trash. Recovery is through the operating system's trash.\n- External source imports remove only their discovery links and keep the external source files. Package-owned Skills must be removed through their owning package. Cindy's built-in Skills cannot be uninstalled, but they can be disabled. Skills provided by Cindy plugins are managed on the owning plugin's page, including when discovered through shared Skill links.\n- Offline removal of an automatically synced skill is remembered on this device, including after restart or sign-in. Automatic sync skips it until you explicitly install it again.\n- Uninstalling a shared copy affects external CLIs that use it. It does not unpublish a skill or delete other users' copies. If file removal fails, Cindy keeps the installation. If cleanup is interrupted, the notice offers **Retry cleanup**. The unfinished operation survives closing, reloading, and restarting Cindy; reopen Skills in the same Cindy profile and account to continue. Cindy pauses conflicting installations until cleanup completes. Retrying never moves files to the trash a second time and preserves externally restored or replaced content.\n\n**Publishing your own skill:**\n\n- Find the publish action on the Skills page and point it at the skill's local folder. It zips the folder and uploads it — reading your directory in place, without copying or moving anything.\n- On first publish, you set the skill's **visibility**: PUBLIC (anyone in the org) or DEPARTMENT_SCOPED (only the departments you choose).\n- The local registry records what you published, so the app knows it's \"yours\" for future updates.\n\n**Updating an already-published skill:**\n\n- On your own skill's detail page you'll see a **发布新版本** (Publish New Version) button.\n- Edit the local folder however you want and publish — the version is **auto-incremented server-side**, you don't pick a number.\n- **Old versions stay live alongside the new one.** Users who already installed an older version keep it until they choose to update.\n- The display name and description are sent on every republish, so editing those metadata fields just means doing a republish.\n\n**Managing an already-published skill:**\n\n- Change who can see or use your skill from the management menu — public, shared with selected teams / departments, or private to you.\n- **Unpublish** makes it private again and returns ownership to your personal scope; it does not remove copies other users already installed.\n- **Authorship is fixed.** Only the original author's account can publish new versions of a given skill (enforced server-side as `NOT_AUTHOR`).\n\n**Browsing and installing others' skills:**\n\n- The marketplace lets you install skills into your global skills directory. You can request a specific version on install; the local registry tracks which version you have.\n\n**Notes:**\n\n- A skill folder without a `SKILL.md` at its root won't be picked up (lowercase `skill.md` is also accepted).\n- Project-scoped skills only show up in sessions whose working directory matches — useful for skills tied to a particular repo's conventions.\n- Editing files inside an installed skill folder takes effect on the next session start; you don't need to reinstall.\n- Uninstalling only removes your local copy. For your own published skills, use unpublish or manage visibility to change market availability.\n\nIn a new-task draft, the slash hover panel offers detail links for global skills. Project skill detail links are available after creating a task, when SkillHub can include that project in its scan.",
+ content: "Skills are reusable agent capabilities you package as a folder and load into your sessions. They're managed on the same page as Plugins — **Skills** and **Plugins** are two tabs of one management surface (the Skills tab is the in-app browser for finding, installing, publishing, and updating skills).\n\n**Skills work across local agents:**\n\n- Skills are **engine-shared** — the same installed Skill is available to Claude Code, Codex, and Pi, so you install it once.\n\n**Where skills live on disk:**\n\n- Global (available to every session): the shared root `~/.agents/skills/<name>/`, which is cross-linked to `~/.claude/skills/` and `~/.codex/skills/` so every engine sees the same skills. On Windows that's under `C:\\Users\\<you>\\`.\n- Project-scoped (only inside one working directory): `<working-dir>/.agents/skills/<name>/` or `<working-dir>/.claude/skills/<name>/`.\n- Each skill is its own folder with a required `SKILL.md` at the root (the prompt / spec the agent reads). Sibling files and subfolders in that folder are also visible to the agent.\n\n**Importing a local skill:**\n\n- On the Skills page, use **Import skill** (top-right) to pick a `.zip` package or a standalone `SKILL.md` file.\n- A zip must contain a `SKILL.md` (at the package root, or inside a single top-level folder). The YAML frontmatter must include non-empty `name` and `description` fields; `name` must match `^[a-z0-9-]{1,200}$`.\n- You then choose where to install: global, a known project, or another directory. Cindy extracts metadata from the file automatically and lists the skill with that name and description.\n- Imported skills can be uninstalled from the detail page, and you can publish them to SkillHub later if you want.\n\n**Using an installed skill:**\n\n- Hover over a local skill in the `/` suggestions and choose **View skill details** in its information panel to open that exact skill. This does not insert or send the command. Pi package skills remain usable from `/`, but do not show this local detail shortcut; manage them through their package.\n\n- Type `/` in the composer to open the slash-command palette; your installed skills show up there alongside built-in and agent commands. Pick one to run it.\n\n**Creating a Skill from the composer:**\n\n- Cindy includes `/cindy-skill-creator`. Invoke it with a description of the Skill you want, such as `/cindy-skill-creator Create a Skill that checks release notes`. Invoking it without a description asks what you want to create.\n- The current Agent creates or updates the Skill directly with its normal file tools. It does not use the `/learn` staging flow.\n- Unless you request another location, new Skills go to `~/.agents/skills/<name>/`. Ask for a project-specific Skill to create it under `<working-dir>/.agents/skills/<name>/`.\n- The built-in `cindy-skill-creator` appears in the local Skill list. You can disable or enable it there; because it ships with Cindy, it cannot be uninstalled. The setting applies to new or restarted Agent sessions.\n\n**Disabling or uninstalling a local skill (Desktop):**\n\n- Open a skill's detail page to use the switch in the top action bar. For a market skill installed in multiple locations, select the local copy from the location dropdown beside the switch. Turning it off keeps the files and removes the skill from new-task command previews. Active tasks retain the skill preference snapshot applied when their Agent started, including their command palette. New or restarted Claude Code, Codex, and Pi agents apply that choice; an already-running agent keeps its existing context.\n- Renaming a local skill while publishing keeps its enabled or disabled setting. If renaming fails, Cindy restores the original folder and content.\n- The switch is local to this device and Cindy profile. It does not edit external CLI settings, sync to other devices, or override a native engine's own disabled state. Enable it again to let the engine discover it normally.\n- In the skill's details, use **… → Uninstall skill**. Confirm the location and shared-file impact. Standalone skills, including locally written skills without a market installation record, move to the system trash. Recovery is through the operating system's trash.\n- External source imports remove only their discovery links and keep the external source files. Package-owned Skills must be removed through their owning package. Cindy's built-in Skills cannot be uninstalled, but they can be disabled. Skills provided by Cindy plugins are managed on the owning plugin's page, including when discovered through shared Skill links.\n- Offline removal of an automatically synced skill is remembered on this device, including after restart or sign-in. Automatic sync skips it until you explicitly install it again.\n- Uninstalling a shared copy affects external CLIs that use it. It does not unpublish a skill or delete other users' copies. If file removal fails, Cindy keeps the installation. If cleanup is interrupted, the notice offers **Retry cleanup**. The unfinished operation survives closing, reloading, and restarting Cindy; reopen Skills in the same Cindy profile and account to continue. Cindy pauses conflicting installations until cleanup completes. Retrying never moves files to the trash a second time and preserves externally restored or replaced content.\n\n**Publishing your own skill:**\n\n- Find the publish action on the Skills page and point it at the skill's local folder. It zips the folder and uploads it — reading your directory in place, without copying or moving anything.\n- On first publish, you set the skill's **visibility**: PUBLIC (anyone in the org) or DEPARTMENT_SCOPED (only the departments you choose).\n- The local registry records what you published, so the app knows it's \"yours\" for future updates.\n\n**Updating an already-published skill:**\n\n- On your own skill's detail page you'll see a **发布新版本** (Publish New Version) button.\n- Edit the local folder however you want and publish — the version is **auto-incremented server-side**, you don't pick a number.\n- **Old versions stay live alongside the new one.** Users who already installed an older version keep it until they choose to update.\n- The display name and description are sent on every republish, so editing those metadata fields just means doing a republish.\n\n**Managing an already-published skill:**\n\n- Change who can see or use your skill from the management menu — public, shared with selected teams / departments, or private to you.\n- **Unpublish** makes it private again and returns ownership to your personal scope; it does not remove copies other users already installed.\n- **Authorship is fixed.** Only the original author's account can publish new versions of a given skill (enforced server-side as `NOT_AUTHOR`).\n\n**Browsing and installing others' skills:**\n\n- The marketplace lets you install skills into your global skills directory. You can request a specific version on install; the local registry tracks which version you have.\n\n**Notes:**\n\n- A skill folder without a `SKILL.md` at its root won't be picked up (lowercase `skill.md` is also accepted).\n- Project-scoped skills only show up in sessions whose working directory matches — useful for skills tied to a particular repo's conventions.\n- Editing files inside an installed skill folder takes effect on the next session start; you don't need to reinstall.\n- Uninstalling only removes your local copy. For your own published skills, use unpublish or manage visibility to change market availability.\n\nIn a new-task draft, the slash hover panel offers detail links for global skills. Project skill detail links are available after creating a task, when SkillHub can include that project in its scan.",
},
{
id: "updates-and-about",
diff --git a/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts b/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts
index ddd551cdd3..80e2ef1485 100644
--- a/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts
@@ -54,7 +54,6 @@ describe('Skill activation preferences', () => {
expect(prefs.readDisabledSkillPaths()).toEqual(expect.arrayContaining([
prefs.skillActivationKey(descriptor.absolutePath),
descriptor.nativeClaudePath,
- descriptor.nativeCodexPath,
]));
await prefs.setCindySkillEnabled(descriptor.absolutePath, true);
});
diff --git a/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts b/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
index 01227cee4f..55568fc8e7 100644
--- a/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
@@ -218,7 +218,7 @@ describe('registerSkillhubIpc usage handlers', () => {
});
it('blocks publishing a Cindy built-in Skill at the Main boundary', async () => {
- const builtInRoot = path.join(fixtureRoot, 'system-skills', 'skill-creator');
+ const builtInRoot = path.join(fixtureRoot, 'system-skills', 'cindy-skill-creator');
const builtInFile = path.join(builtInRoot, 'SKILL.md');
fs.mkdirSync(builtInRoot, { recursive: true });
fs.writeFileSync(builtInFile, '# Built in\n');
@@ -230,10 +230,9 @@ describe('registerSkillhubIpc usage handlers', () => {
getMaker: () => ({ listAgentSkills }) as never,
getManagedSkillRoots,
getBuiltInSkills: () => [{
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
absolutePath: builtInRoot,
- nativeClaudePath: '/tmp/claude-home/skills/skill-creator',
- nativeCodexPath: '/tmp/codex-home/skills/.system/skill-creator',
+ nativeClaudePath: '/tmp/claude-home/skills/cindy-skill-creator',
}],
getAllowedProjectRoots,
marketService: marketService as never,
diff --git a/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts b/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
index 00bcf69ce4..d7bed97fad 100644
--- a/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
@@ -85,17 +85,17 @@ describe('scanAllSkills', () => {
it('always projects the bundled Skill as non-uninstallable and keeps a user same-name copy distinct', async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'skillhub-built-in-'));
tempRoots.push(root);
- const builtIn = path.join(root, 'user-data', 'system-skills', 'skill-creator');
- const userSkill = path.join(root, 'home', '.agents', 'skills', 'skill-creator');
+ const builtIn = path.join(root, 'user-data', 'system-skills', 'cindy-skill-creator');
+ const userSkill = path.join(root, 'home', '.agents', 'skills', 'cindy-skill-creator');
for (const [skillPath, description] of [[builtIn, 'Cindy copy'], [userSkill, 'User copy']] as const) {
fs.mkdirSync(skillPath, { recursive: true });
- fs.writeFileSync(path.join(skillPath, 'SKILL.md'), `---\nname: skill-creator\ndescription: ${description}\n---\nBody\n`);
+ fs.writeFileSync(path.join(skillPath, 'SKILL.md'), `---\nname: cindy-skill-creator\ndescription: ${description}\n---\nBody\n`);
}
const maker = { listCustomizations: vi.fn(async () => ({ errors: [], items: [{
engine: 'codex' as const,
kind: 'skill',
scope: 'user',
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
description: 'User copy',
absolutePath: userSkill,
mdPath: path.join(userSkill, 'SKILL.md'),
@@ -103,15 +103,14 @@ describe('scanAllSkills', () => {
}] })) } as unknown as Maker;
const result = await scanAllSkills({}, maker, [], [{
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
absolutePath: builtIn,
- nativeClaudePath: path.join(root, 'user-data', 'claude-home', 'skills', 'skill-creator'),
- nativeCodexPath: path.join(root, 'user-data', 'codex-home', 'skills', '.system', 'skill-creator'),
+ nativeClaudePath: path.join(root, 'user-data', 'claude-home', 'skills', 'cindy-skill-creator'),
}]);
expect(result.skills).toHaveLength(2);
expect(result.skills.find((skill) => skill.builtIn)).toMatchObject({
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
description: 'Cindy copy',
builtIn: true,
canUninstall: false,
diff --git a/apps/desktop/src/main/skillhub/activationPreferences.ts b/apps/desktop/src/main/skillhub/activationPreferences.ts
index a69d78a7f4..05d1ddef25 100644
--- a/apps/desktop/src/main/skillhub/activationPreferences.ts
+++ b/apps/desktop/src/main/skillhub/activationPreferences.ts
@@ -52,11 +52,11 @@ export function readDisabledSkillPaths(): readonly string[] {
}),
]);
// Cindy's bundled copy normally wins through ~/.agents/skills. Claude uses an
- // isolated config directory in Desktop dev, while Codex can expose its own
- // embedded system copy. Mirror the same user preference to both runtime paths.
+ // isolated config directory in Desktop dev, so mirror the same user preference
+ // to that runtime projection. Codex's own /skill-creator remains independent.
for (const descriptor of builtInSkillDescriptors(app.getPath('userData'))) {
if (value.disabledPaths.includes(skillActivationKey(descriptor.absolutePath))) {
- paths.push(descriptor.nativeClaudePath, descriptor.nativeCodexPath);
+ paths.push(descriptor.nativeClaudePath);
}
}
return [...new Set(paths)];
diff --git a/apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx b/apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx
index 2c1860c257..9aa5d22633 100644
--- a/apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx
@@ -26,6 +26,8 @@ import {
type UnifiedCommand,
} from '@/lib/slashCommands';
import { builtInSkillDescriptionKey } from '@/features/skillhub/lib/builtInSkillPresentation';
+import { OfficialSkillBadge } from '@/features/skillhub/components/OfficialSkillBadge';
+import { isCindyBuiltInSkillMetadata } from '@/../shared/cindyBuiltInSkills';
const TOOLTIP_W = 280;
const TOOLTIP_GAP = 8;
@@ -247,6 +249,7 @@ export function SlashCommandPalette({
filtered.map((cmd, idx) => {
const focused = idx === focusedIndex;
const unavailable = isSlashCommandUnavailable(cmd);
+ const official = cmd.kind === 'agent-skill' && isCindyBuiltInSkillMetadata(cmd);
return (
<button
key={cmd.name}
@@ -274,7 +277,9 @@ export function SlashCommandPalette({
)}
>
<span className="truncate">{cmd.name}</span>
- {metaLabel(cmd) && (
+ {official ? (
+ <OfficialSkillBadge />
+ ) : metaLabel(cmd) && (
<span className="shrink-0 text-12 font-normal text-[var(--cmd-palette-item-meta)]">
{metaLabel(cmd)}
</span>
diff --git a/apps/desktop/src/renderer/components/new-chat/__tests__/SlashCommandPalette.test.tsx b/apps/desktop/src/renderer/components/new-chat/__tests__/SlashCommandPalette.test.tsx
index 32322f743d..1115cc78f0 100644
--- a/apps/desktop/src/renderer/components/new-chat/__tests__/SlashCommandPalette.test.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/__tests__/SlashCommandPalette.test.tsx
@@ -153,7 +153,7 @@ describe('SlashCommandPalette project Skill rows', () => {
it('localizes the built-in Skill Creator description in the input palette', () => {
const skillCreator: UnifiedCommand = {
kind: 'agent-skill',
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
description: 'Create or update a Cindy Skill',
source: 'skill',
scope: 'user',
@@ -171,13 +171,14 @@ describe('SlashCommandPalette project Skill rows', () => {
);
expect(screen.getByText('skillhub.builtIn.skillCreator.description')).toBeTruthy();
+ expect(screen.getByText('skillhub.builtIn.official')).toBeTruthy();
expect(screen.queryByText(skillCreator.description!)).toBeNull();
});
it('keeps a user-owned Skill Creator description unchanged', () => {
const userSkillCreator: UnifiedCommand = {
kind: 'agent-skill',
- name: 'skill-creator',
+ name: 'cindy-skill-creator',
description: 'Create Skills for my private workflow',
source: 'skill',
scope: 'user',
@@ -196,5 +197,6 @@ describe('SlashCommandPalette project Skill rows', () => {
expect(screen.getByText(userSkillCreator.description!)).toBeTruthy();
expect(screen.queryByText('skillhub.builtIn.skillCreator.description')).toBeNull();
+ expect(screen.queryByText('skillhub.builtIn.official')).toBeNull();
});
});
diff --git a/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx b/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
index a446680bc3..ff87a852b8 100644
--- a/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
@@ -1,4 +1,5 @@
import { LocalSkillControls } from './components/LocalSkillControls';
+import { OfficialSkillBadge } from './components/OfficialSkillBadge';
/**
* SkillhubDetailView — route for /skillhub/{kind}/{global|project}/[hash]/:name.
*
@@ -1880,11 +1881,7 @@ export function SkillhubDetailView() {
<h2 className="min-w-0 truncate text-lg font-medium leading-none text-[var(--msg-assistant-text)]">
{(entry.frontmatter?.displayName as string) || (entry.frontmatter?.name as string) || entry.name}
</h2>
- {entry.builtIn && (
- <span className="inline-flex h-5 shrink-0 items-center rounded-full bg-[var(--surface-chip)] px-2 text-11 font-medium leading-none text-[var(--text-primary)]">
- {t('skillhub.home.sourceBuiltIn')}
- </span>
- )}
+ {entry.builtIn && <OfficialSkillBadge />}
<KindChip kind={entry.kind} />
<ScopeChip scope={entry.scope} />
{entry.linkedEngines.map(le => {
diff --git a/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx b/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx
index 347d886e84..b373d694c9 100644
--- a/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx
@@ -53,6 +53,7 @@ import { InstallTargetPicker, type InstallTargetSkill } from './components/Insta
import { SkillCategoryFilterBar } from './components/SkillCategoryFilterBar';
import { HomeMarketCard } from './components/HomeMarketCard';
import { SkillIcon } from './components/SkillIcon';
+import { OfficialSkillBadge } from './components/OfficialSkillBadge';
import { SkillhubMarketPreviewPanel } from './SkillhubMarketPreviewPanel';
import { useSkillhubIdentityPolicy } from './hooks/useSkillhubIdentityPolicy';
@@ -604,13 +605,15 @@ function LocalGroup({
<span className="min-w-0 flex-1 truncate text-13 font-medium text-[var(--text-primary)]">
{s.name}
</span>
- <span className="shrink-0 text-10 text-[var(--text-tertiary)]">
- {s.builtIn
- ? t('skillhub.home.sourceBuiltIn')
- : source === 'skillhub'
- ? t('skillhub.home.sourceSkillhub')
- : t('skillhub.home.sourceLocal')}
- </span>
+ {s.builtIn ? (
+ <OfficialSkillBadge />
+ ) : (
+ <span className="shrink-0 text-10 text-[var(--text-tertiary)]">
+ {source === 'skillhub'
+ ? t('skillhub.home.sourceSkillhub')
+ : t('skillhub.home.sourceLocal')}
+ </span>
+ )}
</span>
{displayDescription && (
<span className="line-clamp-1 text-12 leading-4 text-[var(--text-secondary)]">
diff --git a/apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx b/apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx
new file mode 100644
index 0000000000..8e7b9dea5c
--- /dev/null
+++ b/apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx
@@ -0,0 +1,21 @@
+import { BadgeCheck } from 'lucide-react';
+import { useTranslation } from 'react-i18next';
+
+import { cn } from '@/lib/utils';
+
+export function OfficialSkillBadge({ className }: { className?: string }) {
+ const { t } = useTranslation();
+ return (
+ <span
+ className={cn(
+ 'inline-flex h-5 shrink-0 items-center gap-1 rounded-full bg-[var(--surface-chip)] px-2',
+ 'text-11 font-medium leading-none text-[var(--text-primary)]',
+ className,
+ )}
+ title={t('skillhub.builtIn.officialDetail')}
+ >
+ <BadgeCheck size={12} strokeWidth={2} className="text-[var(--accent-fg)]" aria-hidden="true" />
+ {t('skillhub.builtIn.official')}
+ </span>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/skillhub/lib/builtInSkillPresentation.ts b/apps/desktop/src/renderer/features/skillhub/lib/builtInSkillPresentation.ts
index c399d477d8..0a97b47d19 100644
--- a/apps/desktop/src/renderer/features/skillhub/lib/builtInSkillPresentation.ts
+++ b/apps/desktop/src/renderer/features/skillhub/lib/builtInSkillPresentation.ts
@@ -1,9 +1,4 @@
-const SKILL_CREATOR_NAME = 'skill-creator';
-const SKILL_CREATOR_SOURCE_DESCRIPTIONS = new Set([
- 'Create or update a Cindy Skill',
- 'Create or update a skill',
- 'Create or update a Cindy Skill with appropriately scoped instructions and any needed supporting resources.',
-]);
+import { isCindyBuiltInSkillMetadata } from '../../../../shared/cindyBuiltInSkills';
export const SKILL_CREATOR_DESCRIPTION_KEY = 'skillhub.builtIn.skillCreator.description' as const;
@@ -19,11 +14,5 @@ export function builtInSkillDescriptionKey(
scope?: string;
},
): typeof SKILL_CREATOR_DESCRIPTION_KEY | undefined {
- if (skill.name !== SKILL_CREATOR_NAME) return undefined;
- if (skill.builtIn === true || skill.scope === 'system') {
- return SKILL_CREATOR_DESCRIPTION_KEY;
- }
- return skill.description && SKILL_CREATOR_SOURCE_DESCRIPTIONS.has(skill.description.trim())
- ? SKILL_CREATOR_DESCRIPTION_KEY
- : undefined;
+ return isCindyBuiltInSkillMetadata(skill) ? SKILL_CREATOR_DESCRIPTION_KEY : undefined;
}
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index fc8c7342e6..42be79518a 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -11135,6 +11135,8 @@
"importFailed": "Failed to import skill"
},
"builtIn": {
+ "official": "Official",
+ "officialDetail": "Included and maintained by Cindy.",
"skillCreator": {
"description": "Create or update a Cindy Skill with clear instructions and supporting resources."
}
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index 2dff33e382..e4a653b3e0 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -11119,6 +11119,8 @@
"importFailed": "スキルのインポートに失敗しました"
},
"builtIn": {
+ "official": "公式",
+ "officialDetail": "Cindy がアプリに同梱し、管理しています。",
"skillCreator": {
"description": "明確な手順と必要な補助リソースを備えた Cindy スキルを作成または更新します。"
}
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 0b45455360..0fdb7ac2c8 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -11119,6 +11119,8 @@
"importFailed": "스킬 가져오기 실패"
},
"builtIn": {
+ "official": "공식",
+ "officialDetail": "Cindy가 앱에 포함하고 관리합니다.",
"skillCreator": {
"description": "명확한 지침과 필요한 지원 리소스를 갖춘 Cindy 스킬을 만들거나 업데이트합니다."
}
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index e34d509cce..7bf1975536 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -11119,6 +11119,8 @@
"importFailed": "导入技能失败"
},
"builtIn": {
+ "official": "官方",
+ "officialDetail": "由 Cindy 随应用提供并维护。",
"skillCreator": {
"description": "创建或更新 Cindy 技能,并编写清晰的说明和所需支持资源。"
}
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index 2a8d08443b..1ac8f29a28 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -11119,6 +11119,8 @@
"importFailed": "匯入技能失敗"
},
"builtIn": {
+ "official": "官方",
+ "officialDetail": "由 Cindy 隨應用程式提供並維護。",
"skillCreator": {
"description": "建立或更新 Cindy 技能,並編寫清楚的說明與所需支援資源。"
}
diff --git a/apps/desktop/src/renderer/lib/__tests__/slashCommands.test.ts b/apps/desktop/src/renderer/lib/__tests__/slashCommands.test.ts
index 935014c93e..f674709ab6 100644
--- a/apps/desktop/src/renderer/lib/__tests__/slashCommands.test.ts
+++ b/apps/desktop/src/renderer/lib/__tests__/slashCommands.test.ts
@@ -116,6 +116,25 @@ describe('rewriteAgentSkillInvocationForDispatch', () => {
});
describe('filterSlashCommands', () => {
+ it('places a Cindy built-in Skill before ordinary commands in the initial palette', () => {
+ const commands = [
+ { kind: 'desktop' as const, name: 'help', description: 'Help' },
+ {
+ kind: 'agent-skill' as const,
+ name: 'cindy-skill-creator',
+ description: 'Create or update a Cindy Skill',
+ source: 'skill' as const,
+ },
+ { kind: 'agent-skill' as const, name: 'release-notes', source: 'skill' as const },
+ ];
+
+ expect(filterSlashCommands(commands, '').map((command) => command.name)).toEqual([
+ 'cindy-skill-creator',
+ 'help',
+ 'release-notes',
+ ]);
+ });
+
it('matches command names by case-insensitive containment', () => {
const commands = [
{ kind: 'desktop' as const, name: 'lark-drive', description: 'Drive' },
diff --git a/apps/desktop/src/renderer/lib/slashCommands.ts b/apps/desktop/src/renderer/lib/slashCommands.ts
index 022ef9f17e..b8f0377af9 100644
--- a/apps/desktop/src/renderer/lib/slashCommands.ts
+++ b/apps/desktop/src/renderer/lib/slashCommands.ts
@@ -19,6 +19,7 @@
import type { UnifiedCommand, AgentKind } from '@cindy/maker-core';
import { leadingSlashInvocation } from '@cindy/maker-shared';
import type { PiPackageCommandRuntimeStatus } from '@/../shared/piPackages';
+import { isCindyBuiltInSkillMetadata } from '@/../shared/cindyBuiltInSkills';
export { leadingSlashInvocation };
@@ -272,17 +273,21 @@ export function filterSlashCommands(
limit = 25,
): UnifiedCommand[] {
const q = query.trim().toLowerCase();
- const filtered = q
- ? commands
- .map((command, index) => {
- const name = command.name.toLowerCase();
- const rank = name === q ? 0 : name.startsWith(q) ? 1 : name.includes(q) ? 2 : -1;
- return { command, index, rank };
- })
- .filter((entry) => entry.rank >= 0)
- .sort((a, b) => a.rank - b.rank || a.index - b.index)
- .map((entry) => entry.command)
- : commands;
+ const filtered = commands
+ .map((command, index) => {
+ const name = command.name.toLowerCase();
+ const rank = q ? (name === q ? 0 : name.startsWith(q) ? 1 : name.includes(q) ? 2 : -1) : 0;
+ const officialPriority = command.kind === 'agent-skill'
+ && isCindyBuiltInSkillMetadata(command) ? 0 : 1;
+ return { command, index, rank, officialPriority };
+ })
+ .filter((entry) => entry.rank >= 0)
+ .sort((a, b) => (
+ a.rank - b.rank
+ || a.officialPriority - b.officialPriority
+ || a.index - b.index
+ ))
+ .map((entry) => entry.command);
return filtered.length > limit ? filtered.slice(0, limit) : filtered;
}
diff --git a/apps/desktop/src/shared/cindyBuiltInSkills.ts b/apps/desktop/src/shared/cindyBuiltInSkills.ts
new file mode 100644
index 0000000000..24a4714721
--- /dev/null
+++ b/apps/desktop/src/shared/cindyBuiltInSkills.ts
@@ -0,0 +1,22 @@
+export const CINDY_SKILL_CREATOR_NAME = 'cindy-skill-creator';
+
+const CINDY_SKILL_CREATOR_SOURCE_DESCRIPTIONS = new Set([
+ 'Create or update a Cindy Skill',
+ 'Create or update a skill',
+ 'Create or update a Cindy Skill with appropriately scoped instructions and any needed supporting resources.',
+]);
+
+/** Identify Cindy-owned metadata without treating another vendor's Skill Creator as official. */
+export function isCindyBuiltInSkillMetadata(skill: {
+ builtIn?: boolean;
+ name: string;
+ description?: string;
+ scope?: string;
+}): boolean {
+ if (skill.name !== CINDY_SKILL_CREATOR_NAME) return false;
+ if (skill.builtIn === true || skill.scope === 'system') return true;
+ return Boolean(
+ skill.description
+ && CINDY_SKILL_CREATOR_SOURCE_DESCRIPTIONS.has(skill.description.trim()),
+ );
+}
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index 90e42d7575..11b750e5ee 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -9,7 +9,7 @@
本区块由 `scripts/design-inventory.mjs` 生成,请勿手改。
重新生成:`pnpm design:inventory`;校验:`pnpm check:design-inventory`。
-计数快照日期:2026-09-17。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。
+计数快照日期:2026-09-18。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。
登记 surface 数:50。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。
@@ -41,7 +41,7 @@
| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSegmentedControl.tsx, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 154 | 109 | 734 |
| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/iosSimulatorPluginAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/iosSimulatorFocusBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/IOSSimulatorInstanceGrid.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/IOSSimulatorTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/iosSimulatorH264Decoder.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 149 | 58 | 296 |
| `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及详情 `/skillhub/local/:kind/global/:name`、`/skillhub/local/:kind/project/:projectHash/:name` | InstallTargetPicker, PluginManagementLayout, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubMarketPreviewPanel | apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketPreviewPanel.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx | 46 | 0 | 66 |
-| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketListView, SkillhubMarketPreviewPanel, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketPreviewPanel.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 52 | 0 | 63 |
+| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketListView, SkillhubMarketPreviewPanel, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketPreviewPanel.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 53 | 0 | 64 |
| `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 |
| `desktop.window.ghost-panel` | desktop | 插件面板独立窗口 | `?ghostPanelWindow=<id>` → renderer/ghost-panel-window-entry.tsx;hash `/ghost-panel-window` | GhostPanelWindowLayout | apps/desktop/src/main/ghost-panel-window/controller.ts, apps/desktop/src/main/ghost-panel-window/ipc.ts, apps/desktop/src/main/ghost-panel-window/registry.ts, apps/desktop/src/main/ghost-panel-window/settings-store.ts, apps/desktop/src/main/ghost-panel-window/window.ts, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/ghost-panel-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 59 | 50 | 14 |
| `desktop.window.remote-desktop` | desktop | 远程桌面独立窗口 | `?remoteDesktopViewer=1` → renderer/remote-desktop-viewer-entry.tsx | Button, ConfirmDialog, FormField, RemoteDesktopViewerWindow, Select | apps/desktop/src/main/remote-desktop-viewer/connection.ts, apps/desktop/src/main/remote-desktop-viewer/registry.ts, apps/desktop/src/main/remote-desktop-viewer/windows.ts, apps/desktop/src/renderer/components/ui/button.tsx, apps/desktop/src/renderer/components/ui/confirm-dialog.tsx, apps/desktop/src/renderer/components/ui/form-field.tsx, apps/desktop/src/renderer/components/ui/select.tsx, apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx, apps/desktop/src/renderer/features/remote-desktop/viewerWindow.css, apps/desktop/src/renderer/remote-desktop-viewer-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 99 | 48 | 26 |
diff --git a/docs/legal/README.md b/docs/legal/README.md
index ea37816f0f..10952c3c5c 100644
--- a/docs/legal/README.md
+++ b/docs/legal/README.md
@@ -38,7 +38,7 @@
| [`apps/android-platform-tools-bin/win32-x64/NOTICE.txt`](../../apps/android-platform-tools-bin/win32-x64/NOTICE.txt) | 上游 Android Platform Tools | 必须与随仓库分发的原生二进制保持相邻。 |
| [`apps/desktop/native/sqlite-vec/LICENSE`](../../apps/desktop/native/sqlite-vec/LICENSE) | 上游 sqlite-vec | vendored 原生组件的上游许可证,随组件源码保留。 |
| [`apps/desktop/src/renderer/vendor/drawio/LICENSE`](../../apps/desktop/src/renderer/vendor/drawio/LICENSE)、[`tapdb/LICENSE`](../../apps/desktop/src/renderer/vendor/tapdb/LICENSE) | 各自上游项目 | vendored 前端资源的上游许可证,随资源分发。 |
-| [`apps/desktop/resources/system-skills/skill-creator/license.txt`](../../apps/desktop/resources/system-skills/skill-creator/license.txt) | OpenAI Codex `skill-creator` | 改编并随 Desktop 分发的内置 Skill,上游许可证必须与资源相邻保留。 |
+| [`apps/desktop/resources/system-skills/cindy-skill-creator/license.txt`](../../apps/desktop/resources/system-skills/cindy-skill-creator/license.txt) | OpenAI Codex `skill-creator` | 改编为 `cindy-skill-creator` 并随 Desktop 分发的内置 Skill,上游许可证必须与资源相邻保留。 |
| [`packages/browser-control-runtime/src/_generated/vendor/fs-safe/LICENSE`](../../packages/browser-control-runtime/src/_generated/vendor/fs-safe/LICENSE) | 上游 fs-safe | 生成或 vendored 代码旁的上游许可证,不能与代码拆开。 |
固定路径文件如有变化,应在对应的 `docs/legal/` 说明或生成器中同步登记,而不是
diff --git a/scripts/__tests__/third-party-notices.test.mjs b/scripts/__tests__/third-party-notices.test.mjs
index 9e252d6501..5abbea1d44 100644
--- a/scripts/__tests__/third-party-notices.test.mjs
+++ b/scripts/__tests__/third-party-notices.test.mjs
@@ -291,7 +291,7 @@ test("all shipped desktop notices contain the complete pinned OpenCodex license"
test("all shipped desktop notices inventory the bundled skill creator", () => {
const license = read(
- "apps/desktop/resources/system-skills/skill-creator/license.txt",
+ "apps/desktop/resources/system-skills/cindy-skill-creator/license.txt",
).replace(/\r\n/g, "\n").trim();
for (const artifact of ["desktop-win", "desktop-macos", "desktop-linux"]) {
const notice = read(`docs/legal/notices/${artifact}.txt`).replace(/\r\n/g, "\n");
diff --git a/scripts/generate-third-party-notices.mjs b/scripts/generate-third-party-notices.mjs
index 3caba3a323..9e5765843f 100644
--- a/scripts/generate-third-party-notices.mjs
+++ b/scripts/generate-third-party-notices.mjs
@@ -705,7 +705,7 @@ function buildDesktopCommonEntries(apacheText, sharpPackageNames) {
}),
);
- // Cindy adapts and ships Codex's skill-creator source as a built-in Skill.
+ // Cindy adapts Codex's skill-creator source and ships it as cindy-skill-creator.
entries.push(
bundledComponent({
name: "OpenAI Codex skill-creator (adapted)",
@@ -713,7 +713,7 @@ function buildDesktopCommonEntries(apacheText, sharpPackageNames) {
license: "Apache-2.0",
url: "https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator",
licenseText: readBundledLicense(
- "apps/desktop/resources/system-skills/skill-creator/license.txt",
+ "apps/desktop/resources/system-skills/cindy-skill-creator/license.txt",
),
}),
);