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): add built-in skill creator

xd-bobodc8a2c6a30c0
diff --git a/apps/desktop/forge.config.ts b/apps/desktop/forge.config.ts
index fe7ace53cd..4ec0a405f7 100644
--- a/apps/desktop/forge.config.ts
+++ b/apps/desktop/forge.config.ts
@@ -808,6 +808,8 @@ function extraResourcesForTarget(targetPlatform: string): string[] {
// Input bytes for upgrading retired preset avatars to ordinary managed images.
'resources/legacy-teammate-avatars',
'resources/teammate-portrait-gallery.png',
+ // Cindy-owned Agent Skills are materialized under userData on startup.
+ 'resources/system-skills',
'resources/tools',
'drizzle',
'resources/cc-manager',
diff --git a/apps/desktop/help-knowledge/skills.md b/apps/desktop/help-knowledge/skills.md
index 0759352e8b..6d89ea72ef 100644
--- a/apps/desktop/help-knowledge/skills.md
+++ b/apps/desktop/help-knowledge/skills.md
@@ -1,13 +1,13 @@
---
id: skills
title: Skills (reusable agent capabilities)
-summary: Browse, install, disable, uninstall, publish, and update agent skills; installed skills appear as "/" slash commands and are shared across Claude Code and Codex.
+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.
---
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).
-**Skills work with both agents:**
+**Skills work across local agents:**
-- Skills are **engine-shared** — the same installed skill is available to both Claude Code and Codex, so you install it once.
+- Skills are **engine-shared** — the same installed Skill is available to Claude Code, Codex, and Pi, so you install it once.
**Where skills live on disk:**
@@ -28,13 +28,20 @@ Skills are reusable agent capabilities you package as a folder and load into you
- 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.
+**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.
+- 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.
+
**Disabling or uninstalling a local skill (Desktop):**
- 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.
- Renaming a local skill while publishing keeps its enabled or disabled setting. If renaming fails, Cindy restores the original folder and content.
- 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.
- 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.
-- External source imports remove only their discovery links and keep the external source files. Package-owned or built-in skills must be removed through their owning package; their uninstall action is unavailable here. Skills provided by Cindy plugins are managed on the owning plugin's page, including when discovered through shared skill links.
+- 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.
- 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.
- 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.
diff --git a/apps/desktop/resources/THIRD-PARTY-NOTICES.txt b/apps/desktop/resources/THIRD-PARTY-NOTICES.txt
index 24840a7bca..57ebd1230f 100644
--- a/apps/desktop/resources/THIRD-PARTY-NOTICES.txt
+++ b/apps/desktop/resources/THIRD-PARTY-NOTICES.txt
@@ -3850,6 +3850,213 @@ Apache License
Copyright (c) OpenAI
+------------------------------------------------------------------------------
+OpenAI Codex skill-creator (adapted) 977193486dfe7a88c4dab24abeafe9b754f5b13f
+License: Apache-2.0
+Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
+------------------------------------------------------------------------------
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
------------------------------------------------------------------------------
openclaw fs-safe sources (vendored)
License: MIT
diff --git a/apps/desktop/resources/system-skills/README.md b/apps/desktop/resources/system-skills/README.md
new file mode 100644
index 0000000000..b5dba0b35b
--- /dev/null
+++ b/apps/desktop/resources/system-skills/README.md
@@ -0,0 +1,8 @@
+# Bundled system Skills
+
+`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`)
+
+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/skill-creator/SKILL.md
new file mode 100644
index 0000000000..90f94eac93
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/SKILL.md
@@ -0,0 +1,231 @@
+---
+name: 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
+---
+
+# Skill Creator
+
+Create Skills that give the current Agent useful, non-obvious guidance without constraining unrelated work.
+
+## Core Principles
+
+**Assume the Agent is already capable.** Include only information that changes its decisions or improves its work. Remove generic advice, repeated instructions, speculative edge cases, and examples that do not materially clarify the task.
+
+**Preserve user intent and scope.** A skill should support the requested task, not replace the user's chosen product, expand the assignment, modify unrelated configuration, or imply permission for additional external actions. Do not turn a particular example, past failure, or personal preference into a universal requirement.
+
+Approval to complete a task does not expand its scope or execution permissions. For retrying or externally mutating workflows, define a stopping condition proportional to the risk.
+
+**Match specificity to the risk.** Give the model room to choose an appropriate approach when multiple approaches are reasonable. Use detailed steps, deterministic scripts, or absolute language only when correctness, safety, permissions, or a genuinely fragile workflow requires them.
+
+For open-ended work, describe the outcome and relevant decision criteria. For workflows with a preferred shape, offer useful examples or configurable scripts. Reserve fixed sequences and narrow parameters for operations where deviation would cause a concrete problem. Preserve non-obvious operational invariants, distinguish actual requirements from optional recommendations or local conventions, and avoid restating policies already enforced elsewhere.
+
+**Keep discovery cheap and precise.** Skill names and descriptions are available before a skill is loaded. Describe the actual capability and when it applies, adding exclusions only when they prevent likely misrouting. Avoid exhaustive capability lists and catchalls that attract unrelated requests.
+
+Keep skills self-contained; refer to another skill or tool only when the requested workflow genuinely requires it and it is available in the target environment. Specialized review, hardening, or audit workflows should apply when requested or genuinely needed, not merely because ordinary work touches the same subject.
+
+**Disclose detail progressively.** Keep shared purpose, essential constraints, and useful routing in `SKILL.md`. Put substantial mode-specific guidance, schemas, examples, or procedures in supporting references and read only the references relevant to the current task. A simple self-contained skill does not need a router or extra files.
+
+## Anatomy of a Skill
+
+Every skill is a folder containing a required `SKILL.md` file and any optional resources its actual workflow needs:
+
+```text
+skill-name/
+|-- SKILL.md Required skill instructions
+| |-- YAML frontmatter Required name and description
+| `-- Markdown body Instructions loaded when the skill is used
+|-- agents/ Optional UI metadata and invocation policy
+| `-- openai.yaml
+|-- scripts/ Optional executable helpers
+|-- references/ Optional documentation loaded as needed
+`-- assets/ Optional files used in generated output
+```
+
+Choose the structure that fits the actual task. Some skills are short and self-contained; others route among operating modes or delegate complex mechanics to scripts. Avoid creating directories, placeholders, examples, or ancillary documentation without a clear use.
+
+### SKILL.md
+
+The YAML frontmatter identifies the skill and determines when it should be considered. Include the required `name` and `description`, and preserve supported optional fields such as existing `metadata` when appropriate.
+
+The Markdown body is loaded only when the skill is used. Put the purpose, essential workflow, real constraints, and useful links there. Keep detailed procedures and examples in supporting references when they are relevant only to particular modes.
+
+Skill information is disclosed in three stages:
+
+1. **Name and description:** Available during skill selection, so keep them concise and discriminating.
+2. **SKILL.md body:** Loaded when the skill applies, so keep its instructions relevant to that task.
+3. **Supporting resources:** Read or execute only when the current task actually needs them.
+
+The entrypoint should be as short as the task permits while retaining important constraints. A large upper bound is not a target: move conditional detail into references when doing so improves clarity or context use, rather than waiting for the file to become unwieldy.
+
+### Scripts
+
+Use `scripts/` for executable code when the same logic would otherwise be rewritten repeatedly or deterministic execution materially improves reliability.
+
+- **Example:** `scripts/rotate_pdf.py` for a PDF operation that would otherwise require recreating the same code.
+- **Useful for:** Repeated transformations, reliable API operations, data processing, and other concrete automation.
+- **Validation:** Run new or changed scripts to verify their behavior. Scripts can usually be executed without loading their full implementation into context, although an agent may need to inspect them when patching or adapting them.
+
+### References
+
+Use `references/` for documentation that is needed only in particular contexts.
+
+- **Examples:** `references/schema.md` for database tables, `references/policies.md` for domain rules, `references/api_docs.md` for an API, or separate writing guides for different deliverables.
+- **Useful for:** Schemas, API documentation, company policies, format-specific procedures, detailed workflows, and substantial examples.
+- **Routing:** Link each reference from `SKILL.md` or another relevant resource and explain when it should be read. Keep information in one place instead of duplicating it across the entrypoint and references.
+
+Keep references focused on maintained, task-specific information that changes the agent's decisions. Avoid copied manuals, exhaustive catalogs, and generic tutorials already available from authoritative sources. Before removing existing resources, inspect their callers and purpose.
+
+For large references, include useful search terms or a short contents section when that makes the needed material easier to find.
+
+### Assets
+
+Use `assets/` for files that belong in generated output rather than in the model's instructions.
+
+- **Examples:** `assets/logo.png`, `assets/slides.pptx`, `assets/font.ttf`, or `assets/frontend-template/`.
+- **Useful for:** Templates, images, fonts, icons, boilerplate projects, and other files copied or adapted into the result.
+- **Context:** Do not load assets as instructions unless the task requires inspecting them.
+
+### UI Metadata and Invocation Policy
+
+`agents/openai.yaml` can provide UI-facing metadata such as `display_name`, `short_description`, and `default_prompt`, along with invocation policy. When creating or updating those settings, read [references/openai_yaml.md](references/openai_yaml.md) and keep the values consistent with the skill.
+
+Automatic skill selection is allowed by default. Change that default only when the user explicitly requests an explicit-only skill:
+
+```yaml
+policy:
+ allow_implicit_invocation: false
+```
+
+This keeps the Skill available when explicitly invoked in Cindy as `/skill-name` without adding it to the model context automatically. Preserve unrelated existing UI, policy, and dependency fields when updating `agents/openai.yaml`.
+
+The initializer creates this file automatically. For new or interface-only metadata, generate it with:
+
+```bash
+python3 scripts/generate_openai_yaml.py <path/to/skill-folder> --interface key=value
+```
+
+The generator replaces the entire file. If an existing file contains `policy` or `dependencies`, update only the intended fields in place instead of regenerating it.
+
+Include optional interface fields only when the user provides or requests them.
+
+### What Not to Include
+
+Include files that directly support the skill's work. Avoid adding a `README.md`, installation guide, changelog, duplicated quick reference, or other auxiliary documentation unless a specific task or packaging requirement calls for it.
+
+## Progressive Disclosure in Practice
+
+For a skill with multiple substantial modes, keep the shared guidance and mode-selection criteria in `SKILL.md`. Link each supporting reference where its use becomes relevant. Do not load every reference by default, duplicate reference content in the entrypoint, or add a routing layer when there is nothing meaningful to route.
+
+For example, a deployment skill can keep provider selection in `SKILL.md` and separate provider details:
+
+```text
+cloud-deploy/
+|-- SKILL.md
+`-- references/
+ |-- aws.md
+ |-- gcp.md
+ `-- azure.md
+```
+
+When the user chooses AWS, read `references/aws.md`; do not also load the GCP and Azure guides. The same pattern can separate business domains, deliverable types, or other genuinely distinct operating modes.
+
+A short skill can instead route to details only when an advanced operation needs them:
+
+```markdown
+## Documents
+
+Handle ordinary edits directly.
+
+- For tracked changes, read [references/redlining.md](references/redlining.md).
+- For document internals, read [references/ooxml.md](references/ooxml.md).
+```
+
+These examples illustrate options, not a required structure. Choose the organization that makes the skill easier to use without loading irrelevant material.
+
+## Create or Update a Skill
+
+Adapt the work to the request. Creating a complex new skill may involve understanding realistic use cases, choosing supporting resources, initializing files, writing instructions, and validating the result. A narrow update to an existing skill may require only a focused edit and validation.
+
+If this Skill is invoked without a concrete creation or update request, ask what Skill the user wants and do not create files yet.
+
+Ask clarifying questions only when the missing information matters and cannot be reasonably inferred. Respect a user-specified location. When the user explicitly asks for a project-specific Skill, create it under `<current-workdir>/.agents/skills`; otherwise create it under `~/.agents/skills`. These shared roots make the Skill available to Cindy's local Claude Code, Codex, and Pi Agents. A newly created or updated Skill is picked up by new or restarted Agent sessions.
+
+Keep automatic skill selection enabled unless the user explicitly requests an explicit-only skill. When the intended invocation mode is genuinely unclear and matters to the requested workflow, ask whether the user wants normal automatic discovery or explicit-only invocation; otherwise preserve the default. Do not infer explicit-only invocation from sensitive operations or required approvals: keep the skill discoverable and require authorization immediately before the actual mutation. Preserve an existing skill's invocation policy unless the user asks to change it.
+
+For a new or substantially revised skill, consider the actual requests it should handle and which reusable resources would improve those tasks:
+
+- A repeated PDF transformation may justify a `scripts/rotate_pdf.py` helper.
+- An application-building workflow may benefit from an `assets/frontend-template/` starter.
+- A data-analysis skill may need a `references/schema.md` guide to avoid rediscovering table relationships.
+
+Create those resources only when their concrete benefit justifies them. If the user has already explained the task clearly, proceed without requesting additional examples.
+
+### Naming
+
+- Use lowercase letters, digits, and hyphens.
+- Keep names under 64 characters and prefer short action-oriented names.
+- Namespace by tool or domain when doing so improves discovery.
+- Name the skill folder after the skill.
+
+### Initialize a New Skill
+
+For a new skill, use the bundled initializer when it helps create the required files consistently:
+
+```bash
+python3 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]
+```
+
+For example:
+
+```bash
+python3 scripts/init_skill.py my-skill --path "$HOME/.agents/skills"
+python3 scripts/init_skill.py my-skill --path "$HOME/.agents/skills" --resources references
+```
+
+Request only the resource directories the skill needs. Use `--examples` only when concrete placeholders would help, and replace or remove them before finishing. Do not initialize an existing skill again.
+
+The initializer creates the skill directory, a concise `SKILL.md` starter, and `agents/openai.yaml`. It creates resource directories and example files only when requested. Pass generated UI values as `--interface key=value` when needed.
+
+### Write the Instructions
+
+The frontmatter `description` should briefly explain what the skill does and when it applies. Include a meaningful boundary when similar requests should not activate the skill.
+
+For example:
+
+```yaml
+description: Create or edit Word documents when formatting, tracked changes, or comments require document-specific handling.
+```
+
+Put detailed workflows, tool choices, examples, and operating modes in the body or relevant references rather than listing them all in the description. Preserve supported optional frontmatter, such as existing `metadata`, when appropriate.
+
+Write only the instructions needed for another Agent to perform the task well. State the desired outcome, non-obvious context, real constraints, and relevant references or tools. Preserve the user's explicit choices and existing authorization boundaries. Avoid prescribing a fixed structure, process, or number of steps when the task does not require one.
+
+### Validate and Iterate
+
+Validate the completed skill with:
+
+```bash
+python3 scripts/quick_validate.py <path/to/skill-folder>
+```
+
+The validator checks frontmatter, naming, and unfinished scaffold placeholders; it does not prove that the skill makes good decisions. Also check that descriptions remain discriminating, instructions preserve user intent, references are discoverable, and any added scripts actually work.
+
+When testing is warranted, verify observable behavior or meaningful invariants. Avoid tests that merely match generated wording, headings, or regex patterns.
+
+Improve the skill based on real usage or demonstrated failures. Prefer a narrow correction to accumulating universal rules for every observed example.
+
+## Independent Forward-Testing
+
+Use an independent subagent pass when a skill is sufficiently complex or risky that realistic behavioral validation would add meaningful confidence, and when delegation is available and authorized. Ordinary creation or small edits do not automatically require subagents.
+
+Give the evaluating agent a realistic user request, the skill, and the minimum raw artifacts needed to perform the task. Do not provide the intended answer, suspected bug, proposed fix, or prior conclusions unless the evaluation genuinely requires them.
+
+For example:
+
+```text
+Use $skill-name at /path/to/skill-name to complete this realistic request.
+```
+
+Keep the evaluation scoped to permitted resources and side effects. Use an isolated temporary workspace for generated artifacts so they do not enter the working tree or contaminate later evaluations. Ask for approval when the proposed evaluation would require additional authorization, affect a live production system, or impose substantial time or cost. Review the actual outcome and artifacts, then make only changes supported by the observed behavior.
diff --git a/apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml b/apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml
new file mode 100644
index 0000000000..1448cfa73a
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/agents/openai.yaml
@@ -0,0 +1,5 @@
+interface:
+ display_name: "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/skill-creator/assets/skill-creator-small.svg
new file mode 100644
index 0000000000..c6e4f67c62
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator-small.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 20 20">
+ <path fill="#0D0D0D" d="M12.03 4.113a3.612 3.612 0 0 1 5.108 5.108l-6.292 6.29c-.324.324-.56.561-.791.752l-.235.176c-.205.14-.422.261-.65.36l-.229.093a4.136 4.136 0 0 1-.586.16l-.764.134-2.394.4c-.142.024-.294.05-.423.06-.098.007-.232.01-.378-.026l-.149-.05a1.081 1.081 0 0 1-.521-.474l-.046-.093a1.104 1.104 0 0 1-.075-.527c.01-.129.035-.28.06-.422l.398-2.394c.1-.602.162-.987.295-1.35l.093-.23c.1-.228.22-.445.36-.65l.176-.235c.19-.232.428-.467.751-.79l6.292-6.292Zm-5.35 7.232c-.35.35-.534.535-.66.688l-.11.147a2.67 2.67 0 0 0-.24.433l-.062.154c-.08.22-.124.462-.232 1.112l-.398 2.394-.001.001h.003l2.393-.399.717-.126a2.63 2.63 0 0 0 .394-.105l.154-.063a2.65 2.65 0 0 0 .433-.24l.147-.11c.153-.126.339-.31.688-.66l4.988-4.988-3.227-3.226-4.987 4.988Zm9.517-6.291a2.281 2.281 0 0 0-3.225 0l-.364.362 3.226 3.227.363-.364c.89-.89.89-2.334 0-3.225ZM4.583 1.783a.3.3 0 0 1 .294.241c.117.585.347 1.092.707 1.48.357.385.859.668 1.549.783a.3.3 0 0 1 0 .592c-.69.115-1.192.398-1.549.783-.315.34-.53.77-.657 1.265l-.05.215a.3.3 0 0 1-.588 0c-.117-.585-.347-1.092-.707-1.48-.357-.384-.859-.668-1.549-.783a.3.3 0 0 1 0-.592c.69-.115 1.192-.398 1.549-.783.36-.388.59-.895.707-1.48l.015-.05a.3.3 0 0 1 .279-.19Z"/>
+</svg>
diff --git a/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator.png b/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator.png
new file mode 100644
index 0000000000..4f3d6d82fa
Binary files /dev/null and b/apps/desktop/resources/system-skills/skill-creator/assets/skill-creator.png differ
diff --git a/apps/desktop/resources/system-skills/skill-creator/license.txt b/apps/desktop/resources/system-skills/skill-creator/license.txt
new file mode 100644
index 0000000000..d645695673
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/license.txt
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/apps/desktop/resources/system-skills/skill-creator/references/openai_yaml.md b/apps/desktop/resources/system-skills/skill-creator/references/openai_yaml.md
new file mode 100644
index 0000000000..90f9e8e863
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/references/openai_yaml.md
@@ -0,0 +1,49 @@
+# openai.yaml fields (full example + descriptions)
+
+`agents/openai.yaml` is an extended, product-specific config intended for the machine/harness to read, not the agent. Other product-specific config can also live in the `agents/` folder.
+
+## Full example
+
+```yaml
+interface:
+ display_name: "Optional user-facing name"
+ short_description: "Optional user-facing description"
+ icon_small: "./assets/small-400px.png"
+ icon_large: "./assets/large-logo.svg"
+ brand_color: "#3B82F6"
+ default_prompt: "Optional surrounding prompt to use the skill with"
+
+dependencies:
+ tools:
+ - type: "mcp"
+ value: "github"
+ description: "GitHub MCP server"
+ transport: "streamable_http"
+ url: "https://api.githubcopilot.com/mcp/"
+
+policy:
+ allow_implicit_invocation: true
+```
+
+## Field descriptions and constraints
+
+Top-level constraints:
+
+- Quote all string values.
+- Keep keys unquoted.
+- For `interface.default_prompt`: generate a helpful, short (typically 1 sentence) example starting prompt based on the skill. It must explicitly mention the skill as `$skill-name` (e.g., "Use $skill-name-here to draft a concise weekly status update.").
+
+- `interface.display_name`: Human-facing title shown in UI skill lists and chips.
+- `interface.short_description`: Human-facing short UI blurb (25–64 chars) for quick scanning.
+- `interface.icon_small`: Path to a small icon asset (relative to skill dir). Default to `./assets/` and place icons in the skill's `assets/` folder.
+- `interface.icon_large`: Path to a larger logo asset (relative to skill dir). Default to `./assets/` and place icons in the skill's `assets/` folder.
+- `interface.brand_color`: Hex color used for UI accents (e.g., badges).
+- `interface.default_prompt`: Default prompt snippet inserted when invoking the skill.
+- `dependencies.tools[].type`: Dependency category. Only `mcp` is supported for now.
+- `dependencies.tools[].value`: Identifier of the tool or dependency.
+- `dependencies.tools[].description`: Human-readable explanation of the dependency.
+- `dependencies.tools[].transport`: Connection type when `type` is `mcp`.
+- `dependencies.tools[].url`: MCP server URL when `type` is `mcp`.
+- `policy.allow_implicit_invocation`: When false, the skill is not injected into
+ the model context by default, but can still be invoked explicitly via `$skill`.
+ Defaults to true.
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/generate_openai_yaml.py b/apps/desktop/resources/system-skills/skill-creator/scripts/generate_openai_yaml.py
new file mode 100644
index 0000000000..870eefcea9
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/scripts/generate_openai_yaml.py
@@ -0,0 +1,231 @@
+#!/usr/bin/env python3
+"""
+OpenAI YAML Generator - Creates agents/openai.yaml for a skill folder.
+
+Usage:
+ generate_openai_yaml.py <skill_dir> [--name <skill_name>] [--interface key=value]
+"""
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+ACRONYMS = {
+ "GH",
+ "MCP",
+ "API",
+ "CI",
+ "CLI",
+ "LLM",
+ "PDF",
+ "PR",
+ "UI",
+ "URL",
+ "SQL",
+}
+
+BRANDS = {
+ "openai": "OpenAI",
+ "openapi": "OpenAPI",
+ "github": "GitHub",
+ "pagerduty": "PagerDuty",
+ "datadog": "DataDog",
+ "sqlite": "SQLite",
+ "fastapi": "FastAPI",
+}
+
+SMALL_WORDS = {"and", "or", "to", "up", "with"}
+
+ALLOWED_INTERFACE_KEYS = {
+ "display_name",
+ "short_description",
+ "icon_small",
+ "icon_large",
+ "brand_color",
+ "default_prompt",
+}
+
+
+def yaml_quote(value):
+ escaped = value.replace("\\", "\\\\").replace('"', '\\"').replace("\n", "\\n")
+ return f'"{escaped}"'
+
+
+def format_display_name(skill_name):
+ words = [word for word in skill_name.split("-") if word]
+ formatted = []
+ for index, word in enumerate(words):
+ lower = word.lower()
+ upper = word.upper()
+ if upper in ACRONYMS:
+ formatted.append(upper)
+ continue
+ if lower in BRANDS:
+ formatted.append(BRANDS[lower])
+ continue
+ if index > 0 and lower in SMALL_WORDS:
+ formatted.append(lower)
+ continue
+ formatted.append(word.capitalize())
+ return " ".join(formatted)
+
+
+def generate_short_description(display_name):
+ description = f"Help with {display_name} tasks"
+
+ if len(description) < 25:
+ description = f"Help with {display_name} tasks and workflows"
+ if len(description) < 25:
+ description = f"Help with {display_name} tasks with guidance"
+
+ if len(description) > 64:
+ description = f"Help with {display_name}"
+ if len(description) > 64:
+ description = f"{display_name} helper"
+ if len(description) > 64:
+ description = f"{display_name} tools"
+ if len(description) > 64:
+ suffix = " helper"
+ max_name_length = 64 - len(suffix)
+ trimmed = display_name[:max_name_length].rstrip()
+ description = f"{trimmed}{suffix}"
+ if len(description) > 64:
+ description = description[:64].rstrip()
+
+ if len(description) < 25:
+ description = f"{description} workflows"
+ if len(description) > 64:
+ description = description[:64].rstrip()
+
+ return description
+
+
+def read_frontmatter_name(skill_dir):
+ skill_md = Path(skill_dir) / "SKILL.md"
+ if not skill_md.exists():
+ print(f"[ERROR] SKILL.md not found in {skill_dir}")
+ return None
+ content = skill_md.read_text()
+ match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+ if not match:
+ print("[ERROR] Invalid SKILL.md frontmatter format.")
+ return None
+ frontmatter_text = match.group(1)
+
+ import yaml
+
+ try:
+ frontmatter = yaml.safe_load(frontmatter_text)
+ except yaml.YAMLError as exc:
+ print(f"[ERROR] Invalid YAML frontmatter: {exc}")
+ return None
+ if not isinstance(frontmatter, dict):
+ print("[ERROR] Frontmatter must be a YAML dictionary.")
+ return None
+ name = frontmatter.get("name", "")
+ if not isinstance(name, str) or not name.strip():
+ print("[ERROR] Frontmatter 'name' is missing or invalid.")
+ return None
+ return name.strip()
+
+
+def parse_interface_overrides(raw_overrides):
+ overrides = {}
+ optional_order = []
+ for item in raw_overrides:
+ if "=" not in item:
+ print(f"[ERROR] Invalid interface override '{item}'. Use key=value.")
+ return None, None
+ key, value = item.split("=", 1)
+ key = key.strip()
+ value = value.strip()
+ if not key:
+ print(f"[ERROR] Invalid interface override '{item}'. Key is empty.")
+ return None, None
+ if key not in ALLOWED_INTERFACE_KEYS:
+ allowed = ", ".join(sorted(ALLOWED_INTERFACE_KEYS))
+ print(f"[ERROR] Unknown interface field '{key}'. Allowed: {allowed}")
+ return None, None
+ overrides[key] = value
+ if (
+ key not in ("display_name", "short_description")
+ and key not in optional_order
+ ):
+ optional_order.append(key)
+ return overrides, optional_order
+
+
+def write_openai_yaml(skill_dir, skill_name, raw_overrides):
+ overrides, optional_order = parse_interface_overrides(raw_overrides)
+ if overrides is None:
+ return None
+
+ display_name = overrides.get("display_name") or format_display_name(skill_name)
+ short_description = overrides.get(
+ "short_description"
+ ) or generate_short_description(display_name)
+
+ if not (25 <= len(short_description) <= 64):
+ print(
+ "[ERROR] short_description must be 25-64 characters "
+ f"(got {len(short_description)})."
+ )
+ return None
+
+ interface_lines = [
+ "interface:",
+ f" display_name: {yaml_quote(display_name)}",
+ f" short_description: {yaml_quote(short_description)}",
+ ]
+
+ for key in optional_order:
+ value = overrides.get(key)
+ if value is not None:
+ interface_lines.append(f" {key}: {yaml_quote(value)}")
+
+ agents_dir = Path(skill_dir) / "agents"
+ agents_dir.mkdir(parents=True, exist_ok=True)
+ output_path = agents_dir / "openai.yaml"
+ output_path.write_text("\n".join(interface_lines) + "\n")
+ print(f"[OK] Created agents/openai.yaml")
+ return output_path
+
+
+def main():
+ parser = argparse.ArgumentParser(
+ description="Create agents/openai.yaml for a skill directory.",
+ )
+ parser.add_argument("skill_dir", help="Path to the skill directory")
+ parser.add_argument(
+ "--name",
+ help="Skill name override (defaults to SKILL.md frontmatter)",
+ )
+ parser.add_argument(
+ "--interface",
+ action="append",
+ default=[],
+ help="Interface override in key=value format (repeatable)",
+ )
+ args = parser.parse_args()
+
+ skill_dir = Path(args.skill_dir).resolve()
+ if not skill_dir.exists():
+ print(f"[ERROR] Skill directory not found: {skill_dir}")
+ sys.exit(1)
+ if not skill_dir.is_dir():
+ print(f"[ERROR] Path is not a directory: {skill_dir}")
+ sys.exit(1)
+
+ skill_name = args.name or read_frontmatter_name(skill_dir)
+ if not skill_name:
+ sys.exit(1)
+
+ result = write_openai_yaml(skill_dir, skill_name, args.interface)
+ if result:
+ sys.exit(0)
+ sys.exit(1)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/init_skill.py b/apps/desktop/resources/system-skills/skill-creator/scripts/init_skill.py
new file mode 100644
index 0000000000..2ed2fa3125
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/scripts/init_skill.py
@@ -0,0 +1,308 @@
+#!/usr/bin/env python3
+"""
+Skill Initializer - Creates a new skill from template
+
+Usage:
+ init_skill.py <skill-name> --path <path> [--resources scripts,references,assets] [--examples] [--interface key=value]
+
+Examples:
+ init_skill.py my-new-skill --path skills/public
+ init_skill.py my-new-skill --path skills/public --resources scripts,references
+ init_skill.py my-api-helper --path skills/private --resources scripts --examples
+ init_skill.py custom-skill --path /custom/location
+ init_skill.py my-skill --path skills/public --interface short_description="Short UI label"
+"""
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+from generate_openai_yaml import write_openai_yaml
+
+MAX_SKILL_NAME_LENGTH = 64
+ALLOWED_RESOURCES = {"scripts", "references", "assets"}
+
+SKILL_TEMPLATE = """---
+name: {skill_name}
+description: "[TODO: Briefly describe what this skill does and when it applies.]"
+---
+
+# {skill_title}
+
+[TODO: Add the task-specific guidance Codex needs. Reference supporting files only when they are relevant.]
+"""
+
+EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
+"""
+Example helper script for {skill_name}
+
+This is a placeholder script that can be executed directly.
+Replace with actual implementation or delete if not needed.
+
+Example real scripts from other skills:
+- pdf/scripts/fill_fillable_fields.py - Fills PDF form fields
+- pdf/scripts/convert_pdf_to_images.py - Converts PDF pages to images
+"""
+
+def main():
+ print("This is an example script for {skill_name}")
+ # TODO: Add actual script logic here
+ # This could be data processing, file conversion, API calls, etc.
+
+if __name__ == "__main__":
+ main()
+'''
+
+EXAMPLE_REFERENCE = """# Reference for {skill_title}
+
+Replace this placeholder with maintained, task-specific details that Codex
+would not reliably know, such as operational constraints, local schemas, or
+fragile integration behavior.
+
+Delete this file if no supported workflow needs it.
+"""
+
+EXAMPLE_ASSET = """# Example Asset File
+
+This placeholder represents where asset files would be stored.
+Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.
+
+Asset files are NOT intended to be loaded into context, but rather used within
+the output Codex produces.
+
+Example asset files from other skills:
+- Brand guidelines: logo.png, slides_template.pptx
+- Frontend builder: hello-world/ directory with HTML/React boilerplate
+- Typography: custom-font.ttf, font-family.woff2
+- Data: sample_data.csv, test_dataset.json
+
+## Common Asset Types
+
+- Templates: .pptx, .docx, boilerplate directories
+- Images: .png, .jpg, .svg, .gif
+- Fonts: .ttf, .otf, .woff, .woff2
+- Boilerplate code: Project directories, starter files
+- Icons: .ico, .svg
+- Data files: .csv, .json, .xml, .yaml
+
+Note: This is a text placeholder. Actual assets can be any file type.
+"""
+
+
+def normalize_skill_name(skill_name):
+ """Normalize a skill name to lowercase hyphen-case."""
+ normalized = skill_name.strip().lower()
+ normalized = re.sub(r"[^a-z0-9]+", "-", normalized)
+ normalized = normalized.strip("-")
+ normalized = re.sub(r"-{2,}", "-", normalized)
+ return normalized
+
+
+def title_case_skill_name(skill_name):
+ """Convert hyphenated skill name to Title Case for display."""
+ return " ".join(word.capitalize() for word in skill_name.split("-"))
+
+
+def parse_resources(raw_resources):
+ if not raw_resources:
+ return []
+ resources = [item.strip() for item in raw_resources.split(",") if item.strip()]
+ invalid = sorted({item for item in resources if item not in ALLOWED_RESOURCES})
+ if invalid:
+ allowed = ", ".join(sorted(ALLOWED_RESOURCES))
+ print(f"[ERROR] Unknown resource type(s): {', '.join(invalid)}")
+ print(f" Allowed: {allowed}")
+ sys.exit(1)
+ deduped = []
+ seen = set()
+ for resource in resources:
+ if resource not in seen:
+ deduped.append(resource)
+ seen.add(resource)
+ return deduped
+
+
+def create_resource_dirs(
+ skill_dir, skill_name, skill_title, resources, include_examples
+):
+ for resource in resources:
+ resource_dir = skill_dir / resource
+ resource_dir.mkdir(exist_ok=True)
+ if resource == "scripts":
+ if include_examples:
+ example_script = resource_dir / "example.py"
+ example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
+ example_script.chmod(0o755)
+ print("[OK] Created scripts/example.py")
+ else:
+ print("[OK] Created scripts/")
+ elif resource == "references":
+ if include_examples:
+ example_reference = resource_dir / "api_reference.md"
+ example_reference.write_text(
+ EXAMPLE_REFERENCE.format(skill_title=skill_title)
+ )
+ print("[OK] Created references/api_reference.md")
+ else:
+ print("[OK] Created references/")
+ elif resource == "assets":
+ if include_examples:
+ example_asset = resource_dir / "example_asset.txt"
+ example_asset.write_text(EXAMPLE_ASSET)
+ print("[OK] Created assets/example_asset.txt")
+ else:
+ print("[OK] Created assets/")
+
+
+def init_skill(skill_name, path, resources, include_examples, interface_overrides):
+ """
+ Initialize a new skill directory with template SKILL.md.
+
+ Args:
+ skill_name: Name of the skill
+ path: Path where the skill directory should be created
+ resources: Resource directories to create
+ include_examples: Whether to create example files in resource directories
+
+ Returns:
+ Path to created skill directory, or None if error
+ """
+ # Determine skill directory path
+ skill_dir = Path(path).resolve() / skill_name
+
+ # Check if directory already exists
+ if skill_dir.exists():
+ print(f"[ERROR] Skill directory already exists: {skill_dir}")
+ return None
+
+ # Create skill directory
+ try:
+ skill_dir.mkdir(parents=True, exist_ok=False)
+ print(f"[OK] Created skill directory: {skill_dir}")
+ except Exception as e:
+ print(f"[ERROR] Error creating directory: {e}")
+ return None
+
+ # Create SKILL.md from template
+ skill_title = title_case_skill_name(skill_name)
+ skill_content = SKILL_TEMPLATE.format(
+ skill_name=skill_name, skill_title=skill_title
+ )
+
+ skill_md_path = skill_dir / "SKILL.md"
+ try:
+ skill_md_path.write_text(skill_content)
+ print("[OK] Created SKILL.md")
+ except Exception as e:
+ print(f"[ERROR] Error creating SKILL.md: {e}")
+ return None
+
+ # Create agents/openai.yaml
+ try:
+ result = write_openai_yaml(skill_dir, skill_name, interface_overrides)
+ if not result:
+ return None
+ except Exception as e:
+ print(f"[ERROR] Error creating agents/openai.yaml: {e}")
+ return None
+
+ # Create resource directories if requested
+ if resources:
+ try:
+ create_resource_dirs(
+ skill_dir, skill_name, skill_title, resources, include_examples
+ )
+ except Exception as e:
+ print(f"[ERROR] Error creating resource directories: {e}")
+ return None
+
+ # Print next steps
+ print(f"\n[OK] Skill '{skill_name}' initialized successfully at {skill_dir}")
+ print("\nNext steps:")
+ print("1. Edit SKILL.md to complete the TODO items and update the description")
+ if resources:
+ if include_examples:
+ print(
+ "2. Customize or delete the example files in scripts/, references/, and assets/"
+ )
+ else:
+ print("2. Add resources to scripts/, references/, and assets/ as needed")
+ else:
+ print(
+ "2. Create resource directories only if needed (scripts/, references/, assets/)"
+ )
+ print("3. Update agents/openai.yaml if the UI metadata should differ")
+ print("4. Run the validator when ready to check the skill structure")
+ print(
+ "5. Consider independent forward-testing only when complexity or risk warrants it"
+ )
+
+ return skill_dir
+
+
+def main():
+ parser = argparse.ArgumentParser(
+ description="Create a new skill directory with a SKILL.md template.",
+ )
+ parser.add_argument("skill_name", help="Skill name (normalized to hyphen-case)")
+ parser.add_argument("--path", required=True, help="Output directory for the skill")
+ parser.add_argument(
+ "--resources",
+ default="",
+ help="Comma-separated list: scripts,references,assets",
+ )
+ parser.add_argument(
+ "--examples",
+ action="store_true",
+ help="Create example files inside the selected resource directories",
+ )
+ parser.add_argument(
+ "--interface",
+ action="append",
+ default=[],
+ help="Interface override in key=value format (repeatable)",
+ )
+ args = parser.parse_args()
+
+ raw_skill_name = args.skill_name
+ skill_name = normalize_skill_name(raw_skill_name)
+ if not skill_name:
+ print("[ERROR] Skill name must include at least one letter or digit.")
+ sys.exit(1)
+ if len(skill_name) > MAX_SKILL_NAME_LENGTH:
+ print(
+ f"[ERROR] Skill name '{skill_name}' is too long ({len(skill_name)} characters). "
+ f"Maximum is {MAX_SKILL_NAME_LENGTH} characters."
+ )
+ sys.exit(1)
+ if skill_name != raw_skill_name:
+ print(f"Note: Normalized skill name from '{raw_skill_name}' to '{skill_name}'.")
+
+ resources = parse_resources(args.resources)
+ if args.examples and not resources:
+ print("[ERROR] --examples requires --resources to be set.")
+ sys.exit(1)
+
+ path = args.path
+
+ print(f"Initializing skill: {skill_name}")
+ print(f" Location: {path}")
+ if resources:
+ print(f" Resources: {', '.join(resources)}")
+ if args.examples:
+ print(" Examples: enabled")
+ else:
+ print(" Resources: none (create as needed)")
+ print()
+
+ result = init_skill(skill_name, path, resources, args.examples, args.interface)
+
+ if result:
+ sys.exit(0)
+ else:
+ sys.exit(1)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/apps/desktop/resources/system-skills/skill-creator/scripts/quick_validate.py b/apps/desktop/resources/system-skills/skill-creator/scripts/quick_validate.py
new file mode 100644
index 0000000000..e27023ece4
--- /dev/null
+++ b/apps/desktop/resources/system-skills/skill-creator/scripts/quick_validate.py
@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""
+Quick validation script for skills - minimal version
+"""
+
+import re
+import sys
+from pathlib import Path
+
+import yaml
+
+MAX_SKILL_NAME_LENGTH = 64
+
+
+def validate_skill(skill_path):
+ """Basic validation of a skill"""
+ skill_path = Path(skill_path)
+
+ skill_md = skill_path / "SKILL.md"
+ if not skill_md.exists():
+ return False, "SKILL.md not found"
+
+ content = skill_md.read_text()
+ if not content.startswith("---"):
+ return False, "No YAML frontmatter found"
+
+ match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+ if not match:
+ return False, "Invalid frontmatter format"
+
+ frontmatter_text = match.group(1)
+
+ try:
+ frontmatter = yaml.safe_load(frontmatter_text)
+ if not isinstance(frontmatter, dict):
+ return False, "Frontmatter must be a YAML dictionary"
+ except yaml.YAMLError as e:
+ return False, f"Invalid YAML in frontmatter: {e}"
+
+ allowed_properties = {"name", "description", "license", "allowed-tools", "metadata"}
+
+ unexpected_keys = set(frontmatter.keys()) - allowed_properties
+ if unexpected_keys:
+ allowed = ", ".join(sorted(allowed_properties))
+ unexpected = ", ".join(sorted(unexpected_keys))
+ return (
+ False,
+ f"Unexpected key(s) in SKILL.md frontmatter: {unexpected}. Allowed properties are: {allowed}",
+ )
+
+ if "name" not in frontmatter:
+ return False, "Missing 'name' in frontmatter"
+ if "description" not in frontmatter:
+ return False, "Missing 'description' in frontmatter"
+
+ name = frontmatter.get("name", "")
+ if not isinstance(name, str):
+ return False, f"Name must be a string, got {type(name).__name__}"
+ name = name.strip()
+ if name:
+ if not re.match(r"^[a-z0-9-]+$", name):
+ return (
+ False,
+ f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)",
+ )
+ if name.startswith("-") or name.endswith("-") or "--" in name:
+ return (
+ False,
+ f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens",
+ )
+ if len(name) > MAX_SKILL_NAME_LENGTH:
+ return (
+ False,
+ f"Name is too long ({len(name)} characters). "
+ f"Maximum is {MAX_SKILL_NAME_LENGTH} characters.",
+ )
+
+ description = frontmatter.get("description", "")
+ if not isinstance(description, str):
+ return False, f"Description must be a string, got {type(description).__name__}"
+ description = description.strip()
+ if description.startswith("[TODO:"):
+ return False, "Description contains an unfinished TODO placeholder"
+ if description:
+ if "<" in description or ">" in description:
+ return False, "Description cannot contain angle brackets (< or >)"
+ if len(description) > 1024:
+ return (
+ False,
+ f"Description is too long ({len(description)} characters). Maximum is 1024 characters.",
+ )
+
+ body = content[match.end() :]
+ fence_marker = None
+ fence_length = 0
+ for line in body.splitlines():
+ fence = re.match(r"^[ \t]*(?:(?:[-+*]|\d+[.)])[ \t]+)?(`{3,}|~{3,})(.*)$", line)
+ if fence:
+ marker = fence.group(1)
+ if fence_marker is None:
+ fence_marker = marker[0]
+ fence_length = len(marker)
+ elif (
+ marker[0] == fence_marker
+ and len(marker) >= fence_length
+ and not fence.group(2).strip()
+ ):
+ fence_marker = None
+ fence_length = 0
+ continue
+
+ if fence_marker is None and re.fullmatch(
+ r"[ ]{0,3}\[TODO:[^\n]*\][ \t]*", line
+ ):
+ return False, "Skill instructions contain an unfinished TODO placeholder"
+
+ return True, "Skill is valid!"
+
+
+if __name__ == "__main__":
+ if len(sys.argv) != 2:
+ print("Usage: python quick_validate.py <skill_directory>")
+ sys.exit(1)
+
+ valid, message = validate_skill(sys.argv[1])
+ print(message)
+ sys.exit(0 if valid else 1)
diff --git a/apps/desktop/src/main/bootstrap-electron.ts b/apps/desktop/src/main/bootstrap-electron.ts
index aa295d6687..8f50817f2c 100644
--- a/apps/desktop/src/main/bootstrap-electron.ts
+++ b/apps/desktop/src/main/bootstrap-electron.ts
@@ -577,6 +577,12 @@ import { listAllowedSkillhubProjectRoots } from './skillhub/allowedProjectRoots'
import { SkillhubMarketService } from './skillhub/marketService';
import { skillhubAutoSyncService } from './skillhub/autoSyncService';
import { rehydrateCloseSuppression } from './maker-host/rehydrateCloseSuppression.js';
+import {
+ builtInSkillDescriptors,
+ prepareBuiltInSkills,
+ resolveBundledSystemSkillsRoot,
+} from './maker-host/built-in-skills.js';
+import { prepareSharedGlobalSkillLinks } from './maker-host/shared-global-skills.js';
// Maker Core 一阶段重构(新链路)—— 静态 import 避免 dynamic import 触发 vite chunking
// 让 imageProtocol 等需要 app.ready 前注册的模块跑在错误时机。getMaker() 是 lazy 的,
// 静态 import 不会触发 Maker / Agent 的实例化。
@@ -6709,6 +6715,7 @@ const registerIpcHandlers = () => {
registerSkillhubIpc({
getMaker: getMakerCore,
getManagedSkillRoots: () => getGhostManager().managedRootDirs(),
+ getBuiltInSkills: () => builtInSkillDescriptors(app.getPath('userData')),
getAllowedProjectRoots: listAllowedSkillhubProjectRoots,
});
disposeSkillhubAutoSyncAuthListener = authManager.onAuthStateChange((state) => {
@@ -8573,6 +8580,32 @@ app.on('ready', async () => {
await ensureMainAppPresence('app-ready');
+ // Cindy-owned Skills are packaged as immutable resources and copied into a
+ // stable userData path. The shared projection never replaces a user-owned
+ // ~/.agents/skills/<name>, so a same-name user Skill keeps precedence.
+ try {
+ const prepared = await prepareBuiltInSkills({
+ bundledRoot: resolveBundledSystemSkillsRoot({
+ isPackaged: app.isPackaged,
+ appPath: app.getAppPath(),
+ resourcesPath: process.resourcesPath,
+ }),
+ userDataDir: app.getPath('userData'),
+ });
+ for (const warning of prepared.warnings) {
+ createLogger('built-in-skills').warn('built-in Skill preparation warning', { warning });
+ }
+ const shared = await prepareSharedGlobalSkillLinks();
+ for (const warning of shared.warnings) {
+ createLogger('built-in-skills').warn('shared Skill projection warning', { warning });
+ }
+ } catch (error) {
+ // A broken optional Skill must not block the desktop from starting.
+ createLogger('built-in-skills').warn('built-in Skill preparation failed', {
+ error: error instanceof Error ? error.message : String(error),
+ });
+ }
+
// macOS App Translocation fix: when the user launches the app without
// dragging it to /Applications first, macOS runs it from a read-only
// temporary path, which breaks the in-app auto-updater. Prompt the
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
new file mode 100644
index 0000000000..48e81566da
--- /dev/null
+++ b/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts
@@ -0,0 +1,94 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+
+import {
+ builtInSkillDescriptors,
+ prepareBuiltInSkills,
+ resolveBundledSystemSkillsRoot,
+} from '../built-in-skills';
+
+const roots: string[] = [];
+
+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 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',
+ );
+ fs.writeFileSync(path.join(source, 'scripts', 'validate.py'), 'print("ok")\n');
+ return { bundledRoot, source, userDataDir, homeDir };
+}
+
+afterEach(() => {
+ for (const root of roots.splice(0)) fs.rmSync(root, { recursive: true, force: true });
+});
+
+describe('built-in Skills', () => {
+ it('materializes versioned bytes at a stable path and exposes them through the shared root', async () => {
+ const input = fixture();
+ const first = await prepareBuiltInSkills(input);
+ const descriptor = builtInSkillDescriptors(input.userDataDir)[0]!;
+ const link = path.join(input.homeDir, '.agents', 'skills', 'skill-creator');
+ expect(first.changed).toBe(true);
+ expect(first.warnings).toEqual([]);
+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(descriptor.absolutePath));
+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(
+ '# Creator',
+ );
+
+ const second = await prepareBuiltInSkills(input);
+ expect(second.changed).toBe(false);
+
+ fs.writeFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), '# Tampered\n');
+ const repaired = await prepareBuiltInSkills(input);
+ expect(repaired.changed).toBe(true);
+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(
+ '# Creator',
+ );
+
+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nUpdated\n');
+ const updated = await prepareBuiltInSkills(input);
+ expect(updated.changed).toBe(true);
+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(
+ 'Updated',
+ );
+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(descriptor.absolutePath));
+ });
+
+ 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');
+ fs.mkdirSync(userSkill, { recursive: true });
+ fs.writeFileSync(path.join(userSkill, 'SKILL.md'), '# User copy\n');
+
+ const result = await prepareBuiltInSkills(input);
+ expect(fs.readFileSync(path.join(userSkill, 'SKILL.md'), 'utf8')).toBe('# User copy\n');
+ expect(fs.existsSync(path.join(result.descriptors[0]!.absolutePath, 'SKILL.md'))).toBe(true);
+ expect(result.warnings.join('\n')).toContain('already owned by the user');
+ });
+
+ it('resolves source and packaged resource roots', () => {
+ expect(
+ resolveBundledSystemSkillsRoot({
+ isPackaged: false,
+ appPath: '/repo/apps/desktop',
+ resourcesPath: '/app/resources',
+ }),
+ ).toBe(path.join('/repo/apps/desktop', 'resources', 'system-skills'));
+ expect(
+ resolveBundledSystemSkillsRoot({
+ isPackaged: true,
+ appPath: '/repo/apps/desktop',
+ resourcesPath: '/app/resources',
+ }),
+ ).toBe(path.join('/app/resources', 'system-skills'));
+ });
+});
diff --git a/apps/desktop/src/main/maker-host/built-in-skills.ts b/apps/desktop/src/main/maker-host/built-in-skills.ts
new file mode 100644
index 0000000000..f66d6ff43e
--- /dev/null
+++ b/apps/desktop/src/main/maker-host/built-in-skills.ts
@@ -0,0 +1,224 @@
+import { createHash, randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import { promises as fsp } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { atomicWriteFileSync } from '../utils/atomicWriteFile';
+
+export const BUILT_IN_SKILL_CREATOR_NAME = 'skill-creator';
+
+const BUILT_IN_SKILL_NAMES = [BUILT_IN_SKILL_CREATOR_NAME] as const;
+const MANIFEST_FILE = '.cindy-system-skills.json';
+
+export interface BuiltInSkillDescriptor {
+ name: string;
+ absolutePath: string;
+ nativeCodexPath: string;
+}
+
+export interface PrepareBuiltInSkillsOptions {
+ bundledRoot: string;
+ userDataDir: string;
+ homeDir?: string;
+}
+
+export interface PrepareBuiltInSkillsResult {
+ descriptors: BuiltInSkillDescriptor[];
+ changed: boolean;
+ warnings: string[];
+}
+
+interface MaterializationManifest {
+ schemaVersion: 1;
+ fingerprints: Record<string, string>;
+}
+
+export function resolveBundledSystemSkillsRoot(input: {
+ isPackaged: boolean;
+ appPath: string;
+ resourcesPath: string;
+}): string {
+ return input.isPackaged
+ ? path.join(input.resourcesPath, 'system-skills')
+ : path.join(input.appPath, 'resources', 'system-skills');
+}
+
+export function builtInSkillsRoot(userDataDir: string): string {
+ return path.join(userDataDir, 'system-skills');
+}
+
+export function builtInSkillDescriptors(userDataDir: string): BuiltInSkillDescriptor[] {
+ const root = builtInSkillsRoot(userDataDir);
+ return BUILT_IN_SKILL_NAMES.map((name) => ({
+ name,
+ absolutePath: path.join(root, name),
+ nativeCodexPath: path.join(userDataDir, 'codex-home', 'skills', '.system', name),
+ }));
+}
+
+async function hashDirectory(root: string): Promise<string> {
+ const hash = createHash('sha256');
+ const visit = async (directory: string): Promise<void> => {
+ const entries = await fsp.readdir(directory, { withFileTypes: true });
+ entries.sort((a, b) => a.name.localeCompare(b.name));
+ for (const entry of entries) {
+ const absolute = path.join(directory, entry.name);
+ const relative = path.relative(root, absolute).split(path.sep).join('/');
+ hash.update(entry.isDirectory() ? `d\0${relative}\0` : `f\0${relative}\0`);
+ if (entry.isDirectory()) await visit(absolute);
+ else if (entry.isFile()) hash.update(await fsp.readFile(absolute));
+ else throw new Error(`unsupported bundled Skill entry: ${relative}`);
+ }
+ };
+ await visit(root);
+ return hash.digest('hex');
+}
+
+async function readManifest(root: string): Promise<MaterializationManifest> {
+ try {
+ const parsed = JSON.parse(
+ await fsp.readFile(path.join(root, MANIFEST_FILE), 'utf8'),
+ ) as Partial<MaterializationManifest>;
+ if (
+ parsed.schemaVersion === 1 &&
+ parsed.fingerprints &&
+ typeof parsed.fingerprints === 'object'
+ ) {
+ return { schemaVersion: 1, fingerprints: parsed.fingerprints };
+ }
+ } catch {
+ // Missing or unreadable app-owned metadata is repaired from bundled bytes.
+ }
+ return { schemaVersion: 1, fingerprints: {} };
+}
+
+async function writeManifest(root: string, manifest: MaterializationManifest): Promise<void> {
+ const destination = path.join(root, MANIFEST_FILE);
+ atomicWriteFileSync(destination, `${JSON.stringify(manifest, null, 2)}\n`);
+}
+
+async function materializeSkill(
+ source: string,
+ destination: string,
+ expectedFingerprint: string,
+): Promise<boolean> {
+ const skillFile = path.join(source, 'SKILL.md');
+ if (!(await fsp.stat(skillFile).catch(() => null))?.isFile()) {
+ throw new Error(`bundled Skill is missing SKILL.md: ${source}`);
+ }
+
+ const root = path.dirname(destination);
+ const stage = path.join(root, `.${path.basename(destination)}.stage-${randomUUID()}`);
+ const backup = path.join(root, `.${path.basename(destination)}.backup-${randomUUID()}`);
+ await fsp.cp(source, stage, { recursive: true, force: true, errorOnExist: false });
+ const stagedFingerprint = await hashDirectory(stage).catch(() => null);
+ if (stagedFingerprint !== expectedFingerprint) {
+ await fsp.rm(stage, { recursive: true, force: true });
+ throw new Error(`staged Skill fingerprint mismatch: ${path.basename(destination)}`);
+ }
+ let movedExisting = false;
+ try {
+ if (fs.existsSync(destination)) {
+ await fsp.rename(destination, backup);
+ movedExisting = true;
+ }
+ await fsp.rename(stage, destination);
+ } catch (error) {
+ await fsp.rm(stage, { recursive: true, force: true }).catch(() => undefined);
+ if (movedExisting && !fs.existsSync(destination)) {
+ await fsp.rename(backup, destination).catch(() => undefined);
+ }
+ throw error;
+ }
+ if (movedExisting) await fsp.rm(backup, { recursive: true, force: true });
+ return true;
+}
+
+async function ensureSharedEntry(
+ descriptor: BuiltInSkillDescriptor,
+ homeDir: string,
+): Promise<{ changed: boolean; warning?: string }> {
+ const sharedRoot = path.join(homeDir, '.agents', 'skills');
+ const linkPath = path.join(sharedRoot, descriptor.name);
+ await fsp.mkdir(sharedRoot, { recursive: true });
+
+ try {
+ const current = await fsp.realpath(linkPath);
+ const expected = await fsp.realpath(descriptor.absolutePath);
+ if (current === expected) return { changed: false };
+ } catch {
+ // Inspect the lexical entry below; a missing entry may be created.
+ }
+
+ try {
+ await fsp.lstat(linkPath);
+ return {
+ changed: false,
+ warning: `built-in Skill ${descriptor.name} was not linked because ${linkPath} is already owned by the user`,
+ };
+ } catch (error) {
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+ }
+
+ await fsp.symlink(
+ descriptor.absolutePath,
+ linkPath,
+ process.platform === 'win32' ? 'junction' : 'dir',
+ );
+ return { changed: true };
+}
+
+/**
+ * Materialize Cindy-owned Skill bytes under a stable userData path, then expose
+ * them through the shared ~/.agents discovery root without replacing user data.
+ */
+export async function prepareBuiltInSkills(
+ options: PrepareBuiltInSkillsOptions,
+): Promise<PrepareBuiltInSkillsResult> {
+ const root = builtInSkillsRoot(options.userDataDir);
+ const descriptors = builtInSkillDescriptors(options.userDataDir);
+ const warnings: string[] = [];
+ let changed = false;
+ await fsp.mkdir(root, { recursive: true });
+ const manifest = await readManifest(root);
+
+ for (const descriptor of descriptors) {
+ const source = path.join(options.bundledRoot, descriptor.name);
+ try {
+ const fingerprint = await hashDirectory(source);
+ const installedFingerprint = await hashDirectory(descriptor.absolutePath).catch(() => null);
+ if (
+ installedFingerprint !== fingerprint ||
+ manifest.fingerprints[descriptor.name] !== fingerprint
+ ) {
+ changed = (await materializeSkill(source, descriptor.absolutePath, fingerprint)) || changed;
+ manifest.fingerprints[descriptor.name] = fingerprint;
+ }
+ } catch (error) {
+ warnings.push(
+ `could not materialize built-in Skill ${descriptor.name}: ${error instanceof Error ? error.message : String(error)}`,
+ );
+ continue;
+ }
+
+ try {
+ const linked = await ensureSharedEntry(descriptor, options.homeDir ?? os.homedir());
+ changed = linked.changed || changed;
+ if (linked.warning) warnings.push(linked.warning);
+ } catch (error) {
+ warnings.push(
+ `could not expose built-in Skill ${descriptor.name}: ${error instanceof Error ? error.message : String(error)}`,
+ );
+ }
+ }
+
+ try {
+ await writeManifest(root, manifest);
+ } catch (error) {
+ warnings.push(
+ `could not save built-in Skill manifest: ${error instanceof Error ? error.message : String(error)}`,
+ );
+ }
+
+ return { descriptors, changed, warnings };
+}
diff --git a/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts b/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
index 242ac70e00..e569c59d0a 100644
--- a/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
+++ b/apps/desktop/src/main/maker-ipc/helpKnowledge.generated.ts
@@ -143,8 +143,8 @@ export const HELP_KNOWLEDGE: HelpKnowledgeDoc[] = [
{
id: "skills",
title: "Skills (reusable agent capabilities)",
- summary: "Browse, install, disable, uninstall, publish, and update agent skills; installed skills appear as \"/\" slash commands and are shared across Claude Code and Codex.",
- 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 with both agents:**\n\n- Skills are **engine-shared** — the same installed skill is available to both Claude Code and Codex, 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**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 or built-in skills must be removed through their owning package; their uninstall action is unavailable here. 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.",
+ 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.",
},
{
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 09d16a9d64..e69de10214 100644
--- a/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/activationPreferences.test.ts
@@ -45,6 +45,18 @@ describe('Skill activation preferences', () => {
await reloaded.setCindySkillEnabled(b, true);
expect(reloaded.readDisabledSkillPaths()).toEqual([]);
});
+ it('also disables Codex native fallback when the Cindy built-in Skill is disabled', async () => {
+ const prefs = await import('../activationPreferences');
+ const descriptor = (await import('../../maker-host/built-in-skills')).builtInSkillDescriptors(root)[0]!;
+ fs.mkdirSync(descriptor.absolutePath, { recursive: true });
+ fs.writeFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), '# Built in\n');
+ await prefs.setCindySkillEnabled(descriptor.absolutePath, false);
+ expect(prefs.readDisabledSkillPaths()).toEqual(expect.arrayContaining([
+ prefs.skillActivationKey(descriptor.absolutePath),
+ descriptor.nativeCodexPath,
+ ]));
+ await prefs.setCindySkillEnabled(descriptor.absolutePath, true);
+ });
it('persists lexical aliases across restart, bypasses wide Pi scans, and drops retargeted aliases', async () => {
const prefs = await import('../activationPreferences');
const source = path.join(root, 'external');
diff --git a/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts b/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
index 7f322252a8..a587dd0e9c 100644
--- a/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/registerIpcUsage.test.ts
@@ -217,6 +217,36 @@ describe('registerSkillhubIpc usage handlers', () => {
vi.mocked(BrowserWindow.getAllWindows).mockReset().mockReturnValue([]);
});
+ it('blocks publishing a Cindy built-in Skill at the Main boundary', async () => {
+ const builtInRoot = path.join(fixtureRoot, 'system-skills', 'skill-creator');
+ const builtInFile = path.join(builtInRoot, 'SKILL.md');
+ fs.mkdirSync(builtInRoot, { recursive: true });
+ fs.writeFileSync(builtInFile, '# Built in\n');
+ isExistingSkillPathGranted.mockImplementation((candidate: string, roots: Set<string>) => (
+ roots.has(builtInRoot) && candidate === builtInFile
+ ));
+ const { registerSkillhubIpc } = await import('../registerIpc');
+ registerSkillhubIpc({
+ getMaker: () => ({ listAgentSkills }) as never,
+ getManagedSkillRoots,
+ getBuiltInSkills: () => [{
+ name: 'skill-creator',
+ absolutePath: builtInRoot,
+ nativeCodexPath: '/tmp/codex-home/skills/.system/skill-creator',
+ }],
+ getAllowedProjectRoots,
+ marketService: marketService as never,
+ publishService: { publish, cancel } as never,
+ });
+ const event = { sender: { id: 12 } };
+
+ await expect(handlers.get('skillhub:publish')!(event, {
+ absolutePath: builtInFile,
+ })).resolves.toMatchObject({ success: false, message: expect.stringContaining('cannot be published') });
+ expect(assertTrustedAppRendererEvent).toHaveBeenCalledWith(event);
+ expect(publish).not.toHaveBeenCalled();
+ });
+
describe.each([
{ channel: 'skillhub:get-scan-status', field: 'slug', method: 'getScanStatus' },
{ channel: 'skillhub:list-published-versions', field: 'name', method: 'listPublishedVersions' },
diff --git a/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts b/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
index 1941683fed..57bc3ec090 100644
--- a/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
+++ b/apps/desktop/src/main/skillhub/__tests__/scanner.test.ts
@@ -82,6 +82,51 @@ function createSymlinkedSkill() {
}
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');
+ 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`);
+ }
+ const maker = { listCustomizations: vi.fn(async () => ({ errors: [], items: [{
+ engine: 'codex' as const,
+ kind: 'skill',
+ scope: 'user',
+ name: 'skill-creator',
+ description: 'User copy',
+ absolutePath: userSkill,
+ mdPath: path.join(userSkill, 'SKILL.md'),
+ files: [],
+ }] })) } as unknown as Maker;
+
+ const result = await scanAllSkills({}, maker, [], [{
+ name: 'skill-creator',
+ absolutePath: builtIn,
+ nativeCodexPath: path.join(root, 'user-data', 'codex-home', 'skills', '.system', 'skill-creator'),
+ }]);
+
+ expect(result.skills).toHaveLength(2);
+ expect(result.skills.find((skill) => skill.builtIn)).toMatchObject({
+ name: 'skill-creator',
+ description: 'Cindy copy',
+ builtIn: true,
+ canUninstall: false,
+ cindyEnabled: true,
+ linkedEngines: [
+ { engine: 'claude-code', label: 'Claude' },
+ { engine: 'codex', label: 'Codex' },
+ { engine: 'pi', label: 'Pi' },
+ ],
+ });
+ expect(result.skills.find((skill) => !skill.builtIn)).toMatchObject({
+ description: 'User copy',
+ canUninstall: true,
+ });
+ });
+
it('projects the registry slug joined by physical path without replacing native directory names', async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'skillhub-registry-slug-'));
tempRoots.push(root);
diff --git a/apps/desktop/src/main/skillhub/activationPreferences.ts b/apps/desktop/src/main/skillhub/activationPreferences.ts
index 05724bb1f7..ebe4852e33 100644
--- a/apps/desktop/src/main/skillhub/activationPreferences.ts
+++ b/apps/desktop/src/main/skillhub/activationPreferences.ts
@@ -4,6 +4,7 @@ import { randomUUID } from 'node:crypto';
import { app } from 'electron';
import { createLogger } from '../logger';
import { createOverrideSettingsFile } from '../maker-host/override-settings-file';
+import { builtInSkillDescriptors } from '../maker-host/built-in-skills';
/** Device/profile-local user intent; independent of cloud installs and account changes. */
interface SkillActivationPreferences {
@@ -44,12 +45,21 @@ const store = createOverrideSettingsFile<SkillActivationPreferences>({
export function readDisabledSkillPaths(): readonly string[] {
store.invalidateIfChanged();
const value = store.read();
- return [...new Set(value.disabledPaths.flatMap((source) => [source,
+ const paths = value.disabledPaths.flatMap((source) => [source,
...(value.discoveryPaths?.[source] ?? []).filter((alias) => {
try { return fs.existsSync(alias) && skillActivationKey(alias) === source; }
catch { return false; }
}),
- ]))];
+ ]);
+ // Cindy's bundled copy normally wins through ~/.agents/skills. If that
+ // projection is unavailable, Codex can still expose its own embedded system
+ // copy. Mirror the same user preference to that fallback path.
+ for (const descriptor of builtInSkillDescriptors(app.getPath('userData'))) {
+ if (value.disabledPaths.includes(skillActivationKey(descriptor.absolutePath))) {
+ paths.push(descriptor.nativeCodexPath);
+ }
+ }
+ return [...new Set(paths)];
}
export function isCindySkillEnabled(source: string): boolean {
diff --git a/apps/desktop/src/main/skillhub/registerIpc.ts b/apps/desktop/src/main/skillhub/registerIpc.ts
index 67da9f6273..2c5d99ac38 100644
--- a/apps/desktop/src/main/skillhub/registerIpc.ts
+++ b/apps/desktop/src/main/skillhub/registerIpc.ts
@@ -7,6 +7,7 @@ import { tryAcquireSkillInstallLock } from './installLock';
import { randomUUID } from 'node:crypto';
import path from 'node:path';
import type { Maker } from '@cindy/maker-core';
+import type { BuiltInSkillDescriptor } from '../maker-host/built-in-skills';
import { BrowserWindow, dialog, ipcMain } from 'electron';
import { getCurrentDataOwnerId } from '../authManager';
import { activeOwnerScopeKey, getActiveDataOwnerPushStamp, isAppSessionBoundaryPending } from '../appSessionState';
@@ -96,6 +97,7 @@ function assertReviewOwnerCurrent(ownerScope: string): void {
export interface RegisterSkillhubIpcOptions {
getMaker: () => Maker;
getManagedSkillRoots: () => readonly string[];
+ getBuiltInSkills?: () => readonly BuiltInSkillDescriptor[];
getAllowedProjectRoots: () => Promise<readonly string[]>;
marketService?: SkillhubMarketService;
publishService?: SkillPublishService;
@@ -310,6 +312,11 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
success: false as const,
error: 'path was not granted by this renderer\'s latest SkillHub scan',
});
+ const isBuiltInSkillPath = (targetPath: string): boolean => (
+ (options.getBuiltInSkills?.() ?? []).some((skill) => (
+ isExistingSkillPathGranted(targetPath, new Set([skill.absolutePath]))
+ ))
+ );
const sweepLocalImportGrants = () => {
const now = Date.now();
@@ -432,7 +439,12 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
params?.projects,
options.getAllowedProjectRoots,
);
- const result = await scanAllSkills({ projects }, options.getMaker(), options.getManagedSkillRoots());
+ const result = await scanAllSkills(
+ { projects },
+ options.getMaker(),
+ options.getManagedSkillRoots(),
+ options.getBuiltInSkills?.() ?? [],
+ );
if (
scanGenerationBySender.get(event.sender.id) === scanGeneration
&& !isAppSessionBoundaryPending()
@@ -504,6 +516,9 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
'skillhub:write-file',
async (event, params: { filePath: string; content: string }) => {
if (!await hasScannedSkillGrant(event, params.filePath)) return scanGrantDenied();
+ if (isBuiltInSkillPath(params.filePath)) {
+ return { success: false, error: 'Cindy built-in Skills are read-only' };
+ }
return writeSkillFile(params);
},
);
@@ -529,6 +544,9 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
const ownerScope = activeOwnerScopeKey();
const canMutate = () => ownerScope === activeOwnerScopeKey() && !isAppSessionBoundaryPending();
if (!await hasScannedSkillGrant(event, params.absolutePath)) return scanGrantDenied();
+ if (isBuiltInSkillPath(params.absolutePath)) {
+ return { success: false, error: 'Cindy built-in Skills are read-only' };
+ }
if (!canMutate()) return { success: false, error: 'Skill mutation context changed' };
const result = await renameLocalSkill(params, canMutate);
if (result.success) broadcastLocalChange();
@@ -892,7 +910,10 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
ipcMain.handle(
'skillhub:publish',
async (event, params: PublishParams) => {
- void event;
+ assertTrustedAppRendererEvent(event);
+ if (isBuiltInSkillPath(params.absolutePath)) {
+ return { success: false as const, errorCode: 'INTERNAL' as const, message: 'Cindy built-in Skills cannot be published' };
+ }
return publishService.publish(params);
},
);
@@ -1057,7 +1078,7 @@ export function registerSkillhubIpc(options: RegisterSkillhubIpcOptions): void {
'skillhub:uninstall',
async (event, { absolutePath, skillId }: { absolutePath: string; skillId?: string }) => {
const { target, skill } = await requireLocalSkill(event, absolutePath, skillId);
- if (!target || !isLocalSkillTargetCurrent(target) || isPluginManagedSkillPath(target.sourcePath, options.getManagedSkillRoots())) {
+ if (skill.builtIn || !target || !isLocalSkillTargetCurrent(target) || isPluginManagedSkillPath(target.sourcePath, options.getManagedSkillRoots())) {
throwIpcError('PRECONDITION_FAILED', 'Skill cannot be uninstalled; refresh and retry');
}
const ownerId = getCurrentDataOwnerId();
diff --git a/apps/desktop/src/main/skillhub/scanner.ts b/apps/desktop/src/main/skillhub/scanner.ts
index 253fba1066..87e8c6bc8d 100644
--- a/apps/desktop/src/main/skillhub/scanner.ts
+++ b/apps/desktop/src/main/skillhub/scanner.ts
@@ -24,6 +24,7 @@ import os from 'node:os';
import path from 'node:path';
import matter from 'gray-matter';
import type { AgentCustomization, Maker, PiRuntimeCapabilityStatus } from '@cindy/maker-core';
+import type { BuiltInSkillDescriptor } from '../maker-host/built-in-skills';
import { registryService, type StoredInstall } from './registry';
import { reconcileScannedInstall } from './registryReconciliation';
import { isIgnoredSkillPackagePath } from './packageIgnore';
@@ -47,6 +48,7 @@ export interface Skill {
cindyEnabled?: boolean;
canUninstall?: boolean;
managedByPlugin?: boolean;
+ builtIn?: boolean;
uninstallLinkOnly?: boolean;
/** All lexical discovery aliases; Main owns their validation. */
discoveryPaths?: string[];
@@ -197,10 +199,43 @@ function filterSkillPackageFileEntries(rootDir: string, entries: SkillFileEntry[
});
}
+function readBuiltInCustomization(descriptor: BuiltInSkillDescriptor): AgentCustomization {
+ const skillFile = path.join(descriptor.absolutePath, 'SKILL.md');
+ const raw = fs.readFileSync(skillFile, 'utf8');
+ let frontmatter: Record<string, unknown> | undefined;
+ let description: string | undefined;
+ let parseError: string | undefined;
+ try {
+ const parsed = matter(raw);
+ frontmatter = parsed.data;
+ if (typeof parsed.data.description === 'string') {
+ description = parsed.data.description.trim().slice(0, 500) || undefined;
+ }
+ } catch (error) {
+ parseError = error instanceof Error ? error.message : String(error);
+ }
+ const files = fs.readdirSync(descriptor.absolutePath, { withFileTypes: true })
+ .sort((a, b) => a.name.localeCompare(b.name))
+ .map((entry) => ({ name: entry.name, kind: entry.isDirectory() ? 'dir' as const : 'file' as const }));
+ return {
+ engine: 'claude-code',
+ kind: 'skill',
+ scope: 'global',
+ name: descriptor.name,
+ description,
+ absolutePath: descriptor.absolutePath,
+ mdPath: skillFile,
+ files,
+ frontmatter,
+ parseError,
+ };
+}
+
export async function scanAllSkills(
params: { projects?: ProjectInput[] },
maker: Maker,
managedSkillRoots: readonly string[] = [],
+ builtInSkills: readonly BuiltInSkillDescriptor[] = [],
): Promise<ScanResult> {
const projects = params.projects ?? [];
const projectByWorkingDir = new Map<string, ProjectInput>();
@@ -234,6 +269,20 @@ export async function scanAllSkills(
log.error('maker.listCustomizations failed', err);
listed = { items: [], errors: [{ message: err instanceof Error ? err.message : String(err) }] };
}
+ const builtInRealPaths = new Set<string>();
+ for (const descriptor of builtInSkills) {
+ try {
+ const customization = readBuiltInCustomization(descriptor);
+ const realPath = realPathOrNormalized(customization.absolutePath);
+ builtInRealPaths.add(realPath);
+ listed.items.push(customization);
+ } catch (error) {
+ listed.errors.push({
+ path: descriptor.absolutePath,
+ message: `Could not read built-in Skill ${descriptor.name}: ${error instanceof Error ? error.message : String(error)}`,
+ });
+ }
+ }
// ── 过滤 + 跨引擎去重 ──────────────────────────────────────────────────────
// ~/.agents/skills/ 是 agent-agnostic 的共享路径(canonical),实体文件在此。
@@ -297,6 +346,7 @@ export async function scanAllSkills(
scope,
urlKey,
}) => {
+ const builtIn = builtInRealPaths.has(realPath);
const hasIdentityCollision = (identityCounts.get(`${engine}:${urlKey}`) ?? 0) > 1;
// Pi entries are new to this SkillHub projection. Give them a path-derived
// identity even when currently unique, so adding/removing a same-name source
@@ -317,7 +367,13 @@ export async function scanAllSkills(
});
}
}
- const linkedEngines = Array.from(engineSet.values());
+ const linkedEngines = builtIn
+ ? [
+ { engine: 'claude-code' as const, label: 'Claude' },
+ { engine: 'codex' as const, label: 'Codex' },
+ { engine: 'pi' as const, label: 'Pi' },
+ ]
+ : Array.from(engineSet.values());
const skill: Skill = {
id,
@@ -340,11 +396,12 @@ export async function scanAllSkills(
parseError: c.parseError,
registryEntry: null, // 下面 join 阶段填
...(c.kind === 'skill' ? (() => {
- const discoveryPaths = all.map((item) => item.absolutePath);
+ const discoveryPaths = [...new Set(all.map((item) => item.absolutePath))];
const target = inspectLocalSkillTarget(realPath, discoveryPaths, managedSkillRoots);
return { cindyEnabled: isCindySkillEnabled(realPath), discoveryPaths,
+ ...(builtIn ? { builtIn: true } : {}),
managedByPlugin: isPluginManagedSkillPath(realPath, managedSkillRoots),
- canUninstall: target !== null, uninstallLinkOnly: target?.linkOnly ?? false };
+ canUninstall: !builtIn && target !== null, uninstallLinkOnly: target?.linkOnly ?? false };
})() : {}),
...(project ? { projectRoot: project.projectRoot } : {}),
...(projectHash ? { projectHash } : {}),
diff --git a/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx b/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
index d6c27f6667..f234ba4190 100644
--- a/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx
@@ -1305,10 +1305,10 @@ export function SkillhubDetailView() {
registryEntry,
localFolderHash,
publishedStatus,
- identityPolicy.canWrite,
+ identityPolicy.canWrite && entry?.builtIn !== true,
publishDetailState,
),
- [detailState, registryEntry, localFolderHash, publishedStatus, identityPolicy.canWrite, publishDetailState],
+ [detailState, registryEntry, localFolderHash, publishedStatus, identityPolicy.canWrite, entry?.builtIn, publishDetailState],
);
const detailAction = detailActionState?.status ?? null;
const isOutdated = detailActionState?.isOutdated ?? false;
@@ -1351,7 +1351,7 @@ export function SkillhubDetailView() {
const { confirm } = useConfirmDialog();
const openPublish = useCallback(async () => {
- if (entry?.kind !== 'skill' || !identityPolicy.canWrite) return;
+ if (entry?.kind !== 'skill' || entry.builtIn || !identityPolicy.canWrite) return;
if (isPublishedReviewing) {
const shouldProceed = await confirm({
@@ -1701,6 +1701,9 @@ export function SkillhubDetailView() {
if (entry.kind === 'agent') {
return { hidden: true, disabled: true, tip: '' };
}
+ if (entry.builtIn) {
+ return { hidden: true, disabled: true, tip: '' };
+ }
// 装的别人技能不允许编辑
if (detailState?.isMine === false && detailState.origin === 'installed') {
return { hidden: true, disabled: true, tip: '' };
@@ -1870,6 +1873,11 @@ 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>
+ )}
<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 3f4164a3df..f99ee8fdc3 100644
--- a/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx
@@ -596,7 +596,9 @@ function LocalGroup({
{s.name}
</span>
<span className="shrink-0 text-10 text-[var(--text-tertiary)]">
- {source === 'skillhub'
+ {s.builtIn
+ ? t('skillhub.home.sourceBuiltIn')
+ : source === 'skillhub'
? t('skillhub.home.sourceSkillhub')
: t('skillhub.home.sourceLocal')}
</span>
diff --git a/apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx b/apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx
index ca22618e5b..77904e763f 100644
--- a/apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx
@@ -87,7 +87,11 @@ export function LocalSkillControls({ skill, disabled = false, onUninstalled }: {
className="gap-2 rounded-lg text-13">
<Trash2 size={14} />{t('skillhub.detail.uninstall')}
</DropdownMenuItem>
- {!skill.canUninstall && <p className="max-w-56 px-2 py-1 text-11 text-[var(--text-secondary)]">{t(skill.managedByPlugin ? 'skillhub.management.managedByPlugin' : 'skillhub.management.managedElsewhere')}</p>}
+ {!skill.canUninstall && <p className="max-w-56 px-2 py-1 text-11 text-[var(--text-secondary)]">{t(skill.managedByPlugin
+ ? 'skillhub.management.managedByPlugin'
+ : skill.builtIn
+ ? 'skillhub.management.builtInManaged'
+ : 'skillhub.management.managedElsewhere')}</p>}
</DropdownMenuContent>
</DropdownMenu>
</div>
diff --git a/apps/desktop/src/renderer/features/skillhub/components/__tests__/LocalSkillControls.test.tsx b/apps/desktop/src/renderer/features/skillhub/components/__tests__/LocalSkillControls.test.tsx
index 151e9b7960..504b531f8b 100644
--- a/apps/desktop/src/renderer/features/skillhub/components/__tests__/LocalSkillControls.test.tsx
+++ b/apps/desktop/src/renderer/features/skillhub/components/__tests__/LocalSkillControls.test.tsx
@@ -108,6 +108,23 @@ describe('Local Skill management', () => {
expect(screen.getByText('skillhub.management.managedElsewhere')).toBeTruthy();
});
+ it('allows a built-in Skill to be disabled but not uninstalled', async () => {
+ render(<LocalSkillControls skill={{ ...skill, builtIn: true, canUninstall: false }} />);
+ const control = screen.getByRole('switch') as HTMLButtonElement;
+ expect(control.disabled).toBe(false);
+ fireEvent.click(control);
+ await waitFor(() => expect(mocks.setEnabled).toHaveBeenCalledWith({
+ absolutePath: skill.absolutePath,
+ skillId: skill.id,
+ enabled: false,
+ }));
+ fireEvent.keyDown(screen.getByRole('button', { name: 'skillhub.management.moreLabel' }), {
+ key: 'Enter',
+ });
+ expect(await screen.findByText('skillhub.management.builtInManaged')).toBeTruthy();
+ expect((await screen.findByRole('menuitem')).getAttribute('aria-disabled')).toBe('true');
+ });
+
it('offers a cleanup retry with the Main receipt after partial cleanup', async () => {
mocks.uninstall.mockResolvedValueOnce({ success: true, cleanupToken: 'receipt' });
render(<LocalSkillControls skill={skill} />);
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index 213d55c63d..978d8f8495 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -11125,6 +11125,7 @@
"installed": "Installed",
"globalScope": "Global",
"sourceSkillhub": "SkillHub",
+ "sourceBuiltIn": "Built-in",
"sourceLocal": "Local",
"import": "Import skill",
"importAria": "Import a skill from a local zip or SKILL.md",
@@ -11676,6 +11677,7 @@
"unlinkDescription": "Only the local skill entry will be removed. Original files and edits will be kept.",
"sharedImpact": "Other Agents sharing this skill will also be affected. Published versions and installations elsewhere are unaffected.",
"managedElsewhere": "This Skill belongs to another package or shared directory. Remove it at its source.",
+ "builtInManaged": "This Skill is included with Cindy and cannot be uninstalled.",
"managedByPlugin": "This skill is provided by a plugin. Manage it on that plugin’s page.",
"cleanupIncomplete": "Uninstall cleanup for “{{name}}” is unfinished. Retry now or reopen Skills later to continue. Reinstallation is paused until cleanup completes.",
"retryCleanup": "Retry cleanup",
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index ae9e0c4107..a65a1c7d11 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -11109,6 +11109,7 @@
"installed": "インストール済み",
"globalScope": "グローバル",
"sourceSkillhub": "SkillHub",
+ "sourceBuiltIn": "内蔵",
"sourceLocal": "ローカル",
"import": "スキルをインポート",
"importAria": "ローカルの zip または SKILL.md からスキルをインポート",
@@ -11660,6 +11661,7 @@
"unlinkDescription": "ローカルのスキル登録のみを削除します。元のファイルと編集内容は保持されます。",
"sharedImpact": "このスキルを共有する他の Agent にも影響します。公開済みバージョンや別の場所のインストールには影響しません。",
"managedElsewhere": "このスキルは別のパッケージまたは共有ディレクトリで管理されています。提供元で削除してください",
+ "builtInManaged": "このスキルは Cindy に内蔵されているため、アンインストールできません",
"managedByPlugin": "このスキルはプラグインが提供しています。提供元のプラグインページで管理してください。",
"cleanupIncomplete": "「{{name}}」のアンインストール後のクリーンアップが未完了です。再試行するか、後でスキルを開き直して続行してください。完了するまで再インストールはできません。",
"retryCleanup": "整理を再試行",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 55f1716d11..7ed9735742 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -11109,6 +11109,7 @@
"installed": "설치됨",
"globalScope": "전역",
"sourceSkillhub": "SkillHub",
+ "sourceBuiltIn": "내장",
"sourceLocal": "로컬",
"import": "스킬 가져오기",
"importAria": "로컬 zip 또는 SKILL.md에서 스킬 가져오기",
@@ -11660,6 +11661,7 @@
"unlinkDescription": "로컬 스킬 등록만 제거합니다. 원본 파일과 수정 내용은 유지됩니다.",
"sharedImpact": "이 스킬을 공유하는 다른 Agent도 영향을 받습니다. 게시된 버전과 다른 위치에 설치된 스킬에는 영향을 주지 않습니다.",
"managedElsewhere": "이 스킬은 다른 패키지 또는 공유 디렉터리에서 관리됩니다. 원본 위치에서 제거하세요",
+ "builtInManaged": "이 스킬은 Cindy에 내장되어 있어 제거할 수 없습니다",
"managedByPlugin": "이 스킬은 플러그인이 제공합니다. 해당 플러그인 페이지에서 관리하세요.",
"cleanupIncomplete": "“{{name}}”의 제거 정리가 완료되지 않았습니다. 다시 시도하거나 나중에 스킬을 다시 열어 계속하세요. 정리가 완료될 때까지 재설치할 수 없습니다.",
"retryCleanup": "정리 다시 시도",
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 3b5c46055d..181a2715d2 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -11109,6 +11109,7 @@
"installed": "已安装",
"globalScope": "全局",
"sourceSkillhub": "SkillHub",
+ "sourceBuiltIn": "内置",
"sourceLocal": "本地",
"import": "导入技能",
"importAria": "从本地压缩包或 SKILL.md 导入技能",
@@ -11660,6 +11661,7 @@
"unlinkDescription": "仅移除本地技能入口,原文件及修改会保留。",
"sharedImpact": "共用此技能的其他 Agent 也会受影响。云端发布和其他安装位置不受影响。",
"managedElsewhere": "此技能由其他包或共享目录管理,需在其来源处移除",
+ "builtInManaged": "此技能由 Cindy 内置,无法卸载",
"managedByPlugin": "此技能由插件提供,请到所属插件页面管理。",
"cleanupIncomplete": "“{{name}}”的卸载清理尚未完成。请重试;重开技能中心后也可继续。清理完成前无法重新安装。",
"retryCleanup": "重试清理",
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 b419c04969..6a0622ec1f 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -11109,6 +11109,7 @@
"installed": "已安裝",
"globalScope": "全域性",
"sourceSkillhub": "SkillHub",
+ "sourceBuiltIn": "內建",
"sourceLocal": "本地",
"import": "匯入技能",
"importAria": "從本地壓縮包或 SKILL.md 匯入技能",
@@ -11660,6 +11661,7 @@
"unlinkDescription": "僅移除本機技能入口,原始檔案及修改會保留。",
"sharedImpact": "共用此技能的其他 Agent 也會受影響。雲端發布和其他安裝位置不受影響。",
"managedElsewhere": "此技能由其他套件或共用目錄管理,需在其來源處移除",
+ "builtInManaged": "此技能由 Cindy 內建,無法解除安裝",
"managedByPlugin": "此技能由插件提供,請到所屬插件頁面管理。",
"cleanupIncomplete": "「{{name}}」的解除安裝清理尚未完成。請重試;重新開啟技能中心後也可繼續。清理完成前無法重新安裝。",
"retryCleanup": "重試清理",
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index 8d8880e074..e5953724c2 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -6801,6 +6801,7 @@ interface SkillhubSkill {
cindyEnabled?: boolean;
canUninstall?: boolean;
managedByPlugin?: boolean;
+ builtIn?: boolean;
uninstallLinkOnly?: boolean;
discoveryPaths?: string[];
id: string;
diff --git a/docs/legal/README.md b/docs/legal/README.md
index 66065a7f15..ea37816f0f 100644
--- a/docs/legal/README.md
+++ b/docs/legal/README.md
@@ -38,6 +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,上游许可证必须与资源相邻保留。 |
| [`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/docs/legal/notices/THIRD-PARTY-NOTICES.txt b/docs/legal/notices/THIRD-PARTY-NOTICES.txt
index ad60c5dbe2..d407b27f6e 100644
--- a/docs/legal/notices/THIRD-PARTY-NOTICES.txt
+++ b/docs/legal/notices/THIRD-PARTY-NOTICES.txt
@@ -4570,6 +4570,213 @@ Apache License
Copyright (c) OpenAI
+------------------------------------------------------------------------------
+OpenAI Codex skill-creator (adapted) 977193486dfe7a88c4dab24abeafe9b754f5b13f
+License: Apache-2.0
+Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
+------------------------------------------------------------------------------
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
------------------------------------------------------------------------------
openclaw fs-safe sources (vendored)
License: MIT
diff --git a/docs/legal/notices/desktop-linux.txt b/docs/legal/notices/desktop-linux.txt
index 4956e2af8a..1c0f543051 100644
--- a/docs/legal/notices/desktop-linux.txt
+++ b/docs/legal/notices/desktop-linux.txt
@@ -258,6 +258,213 @@ Apache License
Copyright (c) OpenAI
+------------------------------------------------------------------------------
+OpenAI Codex skill-creator (adapted) 977193486dfe7a88c4dab24abeafe9b754f5b13f
+License: Apache-2.0
+Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
+------------------------------------------------------------------------------
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
------------------------------------------------------------------------------
pi coding agent (runtime-downloaded binary) 0.85.1
License: MIT
diff --git a/docs/legal/notices/desktop-macos.txt b/docs/legal/notices/desktop-macos.txt
index 097f9ab15b..863db14cf2 100644
--- a/docs/legal/notices/desktop-macos.txt
+++ b/docs/legal/notices/desktop-macos.txt
@@ -258,6 +258,213 @@ Apache License
Copyright (c) OpenAI
+------------------------------------------------------------------------------
+OpenAI Codex skill-creator (adapted) 977193486dfe7a88c4dab24abeafe9b754f5b13f
+License: Apache-2.0
+Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
+------------------------------------------------------------------------------
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
------------------------------------------------------------------------------
pi coding agent (runtime-downloaded binary) 0.85.1
License: MIT
diff --git a/docs/legal/notices/desktop-win.txt b/docs/legal/notices/desktop-win.txt
index 2164ed88af..d9b36a6b2b 100644
--- a/docs/legal/notices/desktop-win.txt
+++ b/docs/legal/notices/desktop-win.txt
@@ -258,6 +258,213 @@ Apache License
Copyright (c) OpenAI
+------------------------------------------------------------------------------
+OpenAI Codex skill-creator (adapted) 977193486dfe7a88c4dab24abeafe9b754f5b13f
+License: Apache-2.0
+Source: https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator
+------------------------------------------------------------------------------
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
------------------------------------------------------------------------------
pi coding agent (runtime-downloaded binary) 0.85.1
License: MIT
diff --git a/docs/legal/notices/sbom/desktop-linux.spdx.json b/docs/legal/notices/sbom/desktop-linux.spdx.json
index 02fcbc55ca..1061488c0b 100644
--- a/docs/legal/notices/sbom/desktop-linux.spdx.json
+++ b/docs/legal/notices/sbom/desktop-linux.spdx.json
@@ -3,9 +3,9 @@
"dataLicense": "CC0-1.0",
"SPDXID": "SPDXRef-DOCUMENT",
"name": "cindy-desktop-linux",
- "documentNamespace": "https://cindy.app/spdx/desktop-linux/f133b92ea156af8808a851bdd4fc375d9b0cc1c83dee3e165e1b6fe43d781542",
+ "documentNamespace": "https://cindy.app/spdx/desktop-linux/6d44c39660a87797bd66a6c0b1a0d26a20a4f2d7bf79936b38aa470c3f965191",
"creationInfo": {
- "created": "2026-09-10T10:12:32Z",
+ "created": "2026-09-16T15:04:26Z",
"creators": [
"Tool: scripts/generate-third-party-notices.mjs"
]
@@ -91,6 +91,16 @@
"licenseDeclared": "Apache-2.0",
"copyrightText": "NOASSERTION"
},
+ {
+ "name": "OpenAI Codex skill-creator (adapted)",
+ "SPDXID": "SPDXRef-Package-670f3c5f091a0b1c",
+ "versionInfo": "977193486dfe7a88c4dab24abeafe9b754f5b13f",
+ "downloadLocation": "https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator",
+ "filesAnalyzed": false,
+ "licenseConcluded": "Apache-2.0",
+ "licenseDeclared": "Apache-2.0",
+ "copyrightText": "NOASSERTION"
+ },
{
"name": "openclaw fs-safe sources (vendored)",
"SPDXID": "SPDXRef-Package-4e840ef8561a058f",
@@ -15700,6 +15710,11 @@
"relationshipType": "DESCRIBES",
"relatedSpdxElement": "SPDXRef-Package-4f22132a77577bcb"
},
+ {
+ "spdxElementId": "SPDXRef-DOCUMENT",
+ "relationshipType": "DESCRIBES",
+ "relatedSpdxElement": "SPDXRef-Package-670f3c5f091a0b1c"
+ },
{
"spdxElementId": "SPDXRef-DOCUMENT",
"relationshipType": "DESCRIBES",
diff --git a/docs/legal/notices/sbom/desktop-macos.spdx.json b/docs/legal/notices/sbom/desktop-macos.spdx.json
index 7b7fd1db03..66f726d666 100644
--- a/docs/legal/notices/sbom/desktop-macos.spdx.json
+++ b/docs/legal/notices/sbom/desktop-macos.spdx.json
@@ -3,9 +3,9 @@
"dataLicense": "CC0-1.0",
"SPDXID": "SPDXRef-DOCUMENT",
"name": "cindy-desktop-macos",
- "documentNamespace": "https://cindy.app/spdx/desktop-macos/8f94524325fd3b0c3bd77ceabd8a91e7ea366ac9c53c7d8fb64d7d1eeab61bb0",
+ "documentNamespace": "https://cindy.app/spdx/desktop-macos/922d0cc74a95f3e9863cb6b10434d781e561752d90dd92b4e534560800b61467",
"creationInfo": {
- "created": "2026-09-10T10:12:32Z",
+ "created": "2026-09-16T15:04:26Z",
"creators": [
"Tool: scripts/generate-third-party-notices.mjs"
]
@@ -111,6 +111,16 @@
"licenseDeclared": "Apache-2.0",
"copyrightText": "NOASSERTION"
},
+ {
+ "name": "OpenAI Codex skill-creator (adapted)",
+ "SPDXID": "SPDXRef-Package-670f3c5f091a0b1c",
+ "versionInfo": "977193486dfe7a88c4dab24abeafe9b754f5b13f",
+ "downloadLocation": "https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator",
+ "filesAnalyzed": false,
+ "licenseConcluded": "Apache-2.0",
+ "licenseDeclared": "Apache-2.0",
+ "copyrightText": "NOASSERTION"
+ },
{
"name": "openclaw fs-safe sources (vendored)",
"SPDXID": "SPDXRef-Package-4e840ef8561a058f",
@@ -15730,6 +15740,11 @@
"relationshipType": "DESCRIBES",
"relatedSpdxElement": "SPDXRef-Package-4f22132a77577bcb"
},
+ {
+ "spdxElementId": "SPDXRef-DOCUMENT",
+ "relationshipType": "DESCRIBES",
+ "relatedSpdxElement": "SPDXRef-Package-670f3c5f091a0b1c"
+ },
{
"spdxElementId": "SPDXRef-DOCUMENT",
"relationshipType": "DESCRIBES",
diff --git a/docs/legal/notices/sbom/desktop-win.spdx.json b/docs/legal/notices/sbom/desktop-win.spdx.json
index feac62d8af..05d249fdd5 100644
--- a/docs/legal/notices/sbom/desktop-win.spdx.json
+++ b/docs/legal/notices/sbom/desktop-win.spdx.json
@@ -3,9 +3,9 @@
"dataLicense": "CC0-1.0",
"SPDXID": "SPDXRef-DOCUMENT",
"name": "cindy-desktop-win",
- "documentNamespace": "https://cindy.app/spdx/desktop-win/bd303f92c7516f986d25d2b0e8d1678fce0593db824497b4c2462f2f2e1933a4",
+ "documentNamespace": "https://cindy.app/spdx/desktop-win/6b35d887512f64f1da9d732a59f04bd5bb5b2fa905492544e7fd3154b89900af",
"creationInfo": {
- "created": "2026-09-16T04:54:18Z",
+ "created": "2026-09-16T15:04:26Z",
"creators": [
"Tool: scripts/generate-third-party-notices.mjs"
]
@@ -91,6 +91,16 @@
"licenseDeclared": "Apache-2.0",
"copyrightText": "NOASSERTION"
},
+ {
+ "name": "OpenAI Codex skill-creator (adapted)",
+ "SPDXID": "SPDXRef-Package-670f3c5f091a0b1c",
+ "versionInfo": "977193486dfe7a88c4dab24abeafe9b754f5b13f",
+ "downloadLocation": "https://github.com/openai/codex/tree/977193486dfe7a88c4dab24abeafe9b754f5b13f/codex-rs/skills/src/assets/samples/skill-creator",
+ "filesAnalyzed": false,
+ "licenseConcluded": "Apache-2.0",
+ "licenseDeclared": "Apache-2.0",
+ "copyrightText": "NOASSERTION"
+ },
{
"name": "openclaw fs-safe sources (vendored)",
"SPDXID": "SPDXRef-Package-4e840ef8561a058f",
@@ -20528,6 +20538,11 @@
"relationshipType": "DESCRIBES",
"relatedSpdxElement": "SPDXRef-Package-4f22132a77577bcb"
},
+ {
+ "spdxElementId": "SPDXRef-DOCUMENT",
+ "relationshipType": "DESCRIBES",
+ "relatedSpdxElement": "SPDXRef-Package-670f3c5f091a0b1c"
+ },
{
"spdxElementId": "SPDXRef-DOCUMENT",
"relationshipType": "DESCRIBES",
diff --git a/packages/maker-core/src/agents/codex/index.test.ts b/packages/maker-core/src/agents/codex/index.test.ts
index da8f55b89e..b223b4e312 100644
--- a/packages/maker-core/src/agents/codex/index.test.ts
+++ b/packages/maker-core/src/agents/codex/index.test.ts
@@ -6365,7 +6365,10 @@ describe('CodexAgent MCP thread context hooks', () => {
const agent = new CodexAgent(createDeps());
await expect(agent.listAgentSkills({})).resolves.toMatchObject({
- skills: [expect.objectContaining({ name: 'pr-watch', scope: 'user' })],
+ skills: [
+ expect.objectContaining({ name: 'pr-watch', scope: 'user' }),
+ expect.objectContaining({ name: 'skill-creator', scope: 'system' }),
+ ],
});
const request = createdTransports[0].lines
@@ -6376,6 +6379,97 @@ describe('CodexAgent MCP thread context hooks', () => {
await agent.dispose();
});
+ it('keeps an installed skill-creator ahead of the native system fallback', async () => {
+ const home = os.homedir();
+ const installedPath = path.join(home, '.agents', 'skills', 'skill-creator', 'SKILL.md');
+ MockCodexTransport.onCreate = (transport) => {
+ transport.setMockResponse(Method.SkillsList, {
+ result: {
+ data: [{
+ cwd: home,
+ skills: [
+ {
+ name: 'skill-creator',
+ description: 'User copy',
+ path: installedPath,
+ scope: 'user',
+ enabled: true,
+ },
+ {
+ name: 'skill-creator',
+ description: 'System fallback',
+ path: path.join(home, '.codex', 'skills', '.system', 'skill-creator', 'SKILL.md'),
+ scope: 'system',
+ enabled: true,
+ },
+ ],
+ errors: [],
+ }],
+ },
+ });
+ };
+ const agent = new CodexAgent(createDeps());
+
+ const result = await agent.listAgentSkills({});
+ expect(result.skills).toEqual([
+ expect.objectContaining({ name: 'skill-creator', path: installedPath, scope: 'user' }),
+ ]);
+
+ await agent.dispose();
+ });
+
+ it('resolves /skill-creator to the native system Skill when no installed copy exists', async () => {
+ const skillPath = path.join(
+ os.homedir(),
+ '.codex',
+ 'skills',
+ '.system',
+ 'skill-creator',
+ 'SKILL.md',
+ );
+ const agent = new CodexAgent(createDeps());
+ const host = installFakeHost(agent, (method, params) => {
+ if (method === Method.SkillsList) {
+ const { cwds = ['/repo'] } = params as { cwds?: string[] };
+ return {
+ data: cwds.map((cwd) => ({
+ cwd,
+ skills: [{
+ name: 'skill-creator',
+ description: 'Create a Skill',
+ path: skillPath,
+ scope: 'system',
+ enabled: true,
+ }],
+ errors: [],
+ })),
+ };
+ }
+ if (method === Method.TurnStart) return { turn: { id: 'turn-skill-creator' } };
+ return undefined;
+ });
+ const handle = await agent.startSession({
+ sessionId: 'session-system-skill-creator',
+ model: 'gpt-5.4',
+ workingDir: '/repo',
+ });
+
+ await handle.send({
+ type: 'user',
+ content: '/skill-creator Create a release-note checker',
+ });
+
+ const turnStart = host.request.mock.calls.find(
+ ([method]) => method === Method.TurnStart,
+ )?.[1] as { input?: unknown[] };
+ expect(turnStart.input).toEqual([
+ { type: 'skill', name: 'skill-creator', path: skillPath },
+ { type: 'text', text: 'Create a release-note checker' },
+ ]);
+
+ await handle.close();
+ });
+
it('lists remote skills through the target remote app-server host', async () => {
const remoteWorkingDir = '/srv/project';
MockCodexTransport.onCreate = (transport) => {
diff --git a/packages/maker-core/src/agents/codex/index.ts b/packages/maker-core/src/agents/codex/index.ts
index f048160386..7be370de80 100644
--- a/packages/maker-core/src/agents/codex/index.ts
+++ b/packages/maker-core/src/agents/codex/index.ts
@@ -1068,7 +1068,13 @@ function skillDescription(skill: SkillMetadata): string | undefined {
}
function isPaletteVisibleCodexSkill(skill: SkillMetadata): boolean {
- if (!skill.enabled || skill.scope === 'system' || skill.scope === 'admin') return false;
+ if (!skill.enabled || skill.scope === 'admin') return false;
+
+ if (skill.scope === 'system') {
+ const normalizedPath = skill.path.replace(/\\/g, '/').replace(/\/$/, '');
+ return skill.name.toLowerCase() === 'skill-creator'
+ && /\/skills\/\.system\/skill-creator(?:\/skill\.md)?$/i.test(normalizedPath);
+ }
// Codex plugins can contribute internal skills and currently report them as scope=user.
// They remain available to Codex's own dispatch, but Cindy's slash palette should only
@@ -1077,6 +1083,20 @@ function isPaletteVisibleCodexSkill(skill: SkillMetadata): boolean {
return !/\/plugins\/cache\/[^/]+\/[^/]+\/[^/]+\/skills\//i.test(normalizedPath);
}
+function paletteVisibleCodexSkills(skills: readonly SkillMetadata[]): SkillMetadata[] {
+ const visible = skills.filter(isPaletteVisibleCodexSkill);
+ const installedNames = new Set(visible
+ .filter((skill) => skill.scope !== 'system')
+ .map((skill) => skill.name.toLowerCase()));
+ return visible.filter((skill) => skill.scope !== 'system' || !installedNames.has(skill.name.toLowerCase()));
+}
+
+function selectInvocableCodexSkill(skills: readonly SkillMetadata[], name: string): SkillMetadata | undefined {
+ const matching = skills.filter((skill) => skill.enabled && skill.name.toLowerCase() === name.toLowerCase());
+ return matching.find((skill) => skill.scope !== 'system' && skill.scope !== 'admin')
+ ?? matching.find(isPaletteVisibleCodexSkill);
+}
+
function parseLeadingSlashToken(text: string): { name: string; rest: string } | null {
const match = text.match(/^\/([^\s/]+)(?:\s+([\s\S]*))?$/);
if (!match?.[1]) return null;
@@ -1962,8 +1982,7 @@ export class CodexAgent extends BaseAgent {
opts.remoteHostId,
);
const out: ListAgentSkillsResult = {
- skills: skills
- .filter(isPaletteVisibleCodexSkill)
+ skills: paletteVisibleCodexSkills(skills)
.map((skill) => ({
kind: 'agent-skill' as const,
name: skill.name,
@@ -6068,9 +6087,7 @@ export class CodexAgent extends BaseAgent {
try {
const { skills } = await this.listSkillsForCwd(opts.workingDir, false);
- const skill = skills.find(
- (item) => item.enabled && item.name.toLowerCase() === slash.name.toLowerCase(),
- );
+ const skill = selectInvocableCodexSkill(skills, slash.name);
if (!skill) return toAppServerInput(content, opts.workingDir);
const inputs: UserInput[] = [{ type: 'skill', name: skill.name, path: skill.path }];
diff --git a/scripts/__tests__/third-party-notices.test.mjs b/scripts/__tests__/third-party-notices.test.mjs
index fe516053c5..9e252d6501 100644
--- a/scripts/__tests__/third-party-notices.test.mjs
+++ b/scripts/__tests__/third-party-notices.test.mjs
@@ -288,3 +288,23 @@ test("all shipped desktop notices contain the complete pinned OpenCodex license"
assert.ok(notice.includes(`${upstream.repository}/tree/${upstream.commit}`));
}
});
+
+test("all shipped desktop notices inventory the bundled skill creator", () => {
+ const license = read(
+ "apps/desktop/resources/system-skills/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");
+ assert.ok(notice.includes(license), `${artifact} includes the Apache text`);
+ const sbom = JSON.parse(read(`docs/legal/notices/sbom/${artifact}.spdx.json`));
+ const component = sbom.packages.find(pkg => pkg.name === "OpenAI Codex skill-creator (adapted)");
+ assert.ok(component, `${artifact} inventories skill-creator`);
+ assert.equal(component.versionInfo, "977193486dfe7a88c4dab24abeafe9b754f5b13f");
+ assert.equal(component.licenseDeclared, "Apache-2.0");
+ }
+ for (const file of ["apps/desktop/resources/THIRD-PARTY-NOTICES.txt", "docs/legal/notices/THIRD-PARTY-NOTICES.txt"]) {
+ const notice = read(file).replace(/\r\n/g, "\n");
+ assert.ok(notice.includes(license), `${file} includes the Apache text`);
+ assert.match(notice, /OpenAI Codex skill-creator \(adapted\)/);
+ }
+});
diff --git a/scripts/generate-third-party-notices.mjs b/scripts/generate-third-party-notices.mjs
index 54d619144f..3caba3a323 100644
--- a/scripts/generate-third-party-notices.mjs
+++ b/scripts/generate-third-party-notices.mjs
@@ -6,7 +6,7 @@
*
* 范围:根目录及所有 pnpm workspace 包的生产依赖闭包(dependencies +
* optionalDependencies,递归;workspace 内部包只穿透不收录),外加产品分发的
- * 非 npm 资产(安装包内的 ripgrep / Electron,以及运行时下载的 Codex CLI /
+ * 非 npm 资产(安装包内的 ripgrep / Electron / Skill 资源,以及运行时下载的 Codex CLI /
* pi coding agent,另含
* Android Platform-Tools / vendored 代码)的手工条目。
*
@@ -705,6 +705,19 @@ function buildDesktopCommonEntries(apacheText, sharpPackageNames) {
}),
);
+ // Cindy adapts and ships Codex's skill-creator source as a built-in Skill.
+ entries.push(
+ bundledComponent({
+ name: "OpenAI Codex skill-creator (adapted)",
+ version: "977193486dfe7a88c4dab24abeafe9b754f5b13f",
+ 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",
+ ),
+ }),
+ );
+
// pi coding agent — 运行时从 CDN 下载到 userData,不进入安装包
entries.push(
bundledComponent({