Historical version and status
This is the complete historical guide declaring the name xzskill in orziz/odai, pinned to commit 4a694b0cc90bd48ecc3828af4beaf576cbbe2fe7 dated 2026-04-09 UTC. Observed 2026-10-18 UTC. The commit date is not a claimed first publication date for the skill.
The original catalog name, ID, repository and installation command are retained instead of being replaced with a later related entry. Historical workflows, host conventions and installation methods may have changed; current installability of the legacy entry is unverified. The source is reference material here. No installation, modification, review, synchronization, file cleanup or agent-dispatch instruction from it was executed. The source record retains the original Chinese; the English view translates prose while preserving code and source links.
Complete historical guide
name: xzskill description: Based on the standard skills in the skills directory, generate the corresponding manual installation versions and sync the README
xzskill Now executed via the in-repo script scripts/xzskill.js .
Goal
After the user passes in one or more skill names, based on 工程根目录/skills/<skill-name>/ generate the corresponding manual installation files, and perform minimal-scope synchronization on README.md .
Input constraints
- Accepts one or more skill names, for example:
review-sslb harness-sslb。 - If no name is passed in, or any name cannot be unambiguously resolved to a skill name, prompt the user to re-enter.
- Only recognize the
工程根目录/skills/<skill-name>/directory, not from.agentsThe directory takes the installation source. - Do not consider dependencies and do not introduce other skill names.
- If
<skill-name>isxzskill, report an error directly and stop, to avoid self-referential generation.
Execution method
- The Claude command layer only provides a thin wrapper.
- The actual generation logic is uniformly completed by
工程根目录/scripts/xzskill.js. - The script is the sole execution truth; do not let the model manually generate target files according to rules anymore.
Script responsibilities
- Check whether
工程根目录/skills/<skill-name>/SKILL.mdexists; if it does not exist, report an error and stop. - Read
工程根目录/skills/<skill-name>/SKILL.md,use it as the main body source. - If
references/、assets/orscripts/exists in the same directory, treat these directories as auxiliary resources of the current skill and sync them together to each manual installation target directory. .claude/commands/<skill-name>.mdexisting wrapper information (such as the supplementary notes afterallowed-tools、argument-hint、用户输入) as the Claude-side source of truth, and preserve it during generation.- Do not read other skill directories, do not scan unrelated directories in the repository, and do not refer to other skills as templates.
- When generating the target file, by default adopt the "fixed template + direct body copy" strategy:Do not rewrite the source file body, do not reorganize, and do not stylistically rewrite.
- If the body references relative paths under
references/、assets/、scripts/, when generating the manual installation file, rewrite these paths to relative paths usable in the target directory. - First parse the source file frontmatter:
- Read
name - Read
description
- Read
- Then take the main text after the frontmatter of the source file as the sole body payload; keep the paragraph order, heading hierarchy, code blocks, and wording of the main text unchanged.
- Generate or overwrite the following target files directly based on the source file content:
.claude/commands/<skill-name>.md.github/skills/<skill-name>/SKILL.md.trae/skills/<skill-name>.md.trae/rules/<skill-name>.md
- If an auxiliary resource directory exists, synchronize the directory of the same name at the following location:
.claude/commands/<skill-name>/.github/skills/<skill-name>/.trae/skills/<skill-name>/.trae/rules/<skill-name>/
- The generation rules for each target file are fixed as follows, with no on-the-spot judgment:
.claude/commands/<skill-name>.md: retainname、description, and preserve as much as possible the existingallowed-tools、argument-hintand用户输入in that file, then append explanatory notes; after the frontmatter, always append a blank line,用户输入:、$ARGUMENTS, a blank line, and then concatenate the retained section and the source file main text.github/skills/<skill-name>/SKILL.md: retainname、descriptionafter the frontmatter, then directly concatenate the source file main text; place auxiliary resources andSKILL.mdin the same skill directory, and keep the relative paths of resources in the main text in the same form as in the source file.trae/skills/<skill-name>.md: retainname、descriptionafter the frontmatter, then directly concatenate the source file main text; do not rewrite additionally.trae/rules/<skill-name>.md: retainname、descriptionfrontmatter, then directly concatenate the source file body; do not additionally rewrite
- When updating
README.md, handle only the "currently provided" list:
- If
工程根目录/skills/<skill-name>/SKILL.mddoes not exist in the list, append one line - If it already exists, do not add it again
- Do not modify other sections of the README, and do not rewrite the entire text
- If multiple skills are passed in, complete all validation first, then process them one by one, to avoid synchronizing only half.
- Throughout, handle only the currently specified skill, and stop after completion.
Strict restrictions
- Do not modify any content under
.agents. - Do not scan or operate on unrelated skills.
- Do not invent new file formats, and do not extend the installation system.
- Do not search the entire repository for files just to "refer to existing formats".
- If the source skill does not exist, do not perform any writes.
- Except for
工程根目录/skills/<skill-name>/, the current.claude/commands/<skill-name>.md, andREADME.md, do not read any other skill directories. - Do not rewrite the source skill body just to "look more like the target platform"; the body must always be copied verbatim from the source file, with no changes except for the fixed header, the Claude-side preserved section, and rewriting of resource relative paths.
- Do not reorder body sections, do not merge paragraphs, and do not add or remove rules on your own.
- Do not infer platform differences on your own, and do not design extra fields on your own; anything the source file does not state and the rules do not fix must not be added.
- If the generation rules are already fixed, execute according to the fixed template; do not repeatedly compare "whether it could look even more like the target platform".
- When writing to the target file, any occurrence of
$ARGUMENTSin the rules must be treated as a plain-text placeholder: do not expand it, do not substitute it, and do not reference the currently passed-in parameters.
Failure output
- If any source file does not exist:
错误:工程根目录/skills/<skill-name>/SKILL.md 不存在,无法生成手动安装版本。 - If passed
xzskill:错误:xzskill 不支持生成自身的手动安装版本,请改为处理其他 skill。
Successful output
On success, briefly state only:
- which source files were processed;
- which target files were updated for each;
- whether the README was appended to, updated, or already existed;
- synchronization was completed within the minimal necessary scope.
Pinned source, license and attribution
Exact-name original; same-version source directory; same-version license. Original documents by orzi! under MIT. Original text is retained unchanged; the status notes and English translation are editorial additions.
MIT License
Copyright (c) 2026 orzi!
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.