English | 简体中文
Reviewed: 2026-10-20. Local installation, bundled reads and ZIP export are implemented. Client discovery and task execution need separate runtime acceptance; distributing instructions alone does not establish compatibility.
Earlier macOS validation: 137 core tests, 114 real CLI contract checks, four terminal-confirmation checks, and isolated native cleanup/restoration/permanent-removal checks passed. Installation tests cover repeated installs, managed-update backups, preservation of local changes, invalid files, links and ZIP contents without writing real client directories. Computer Use verified the installed Chinese handoff, Codex/Claude Code guidance and Copy Request; a separate-data application copy verified WorkBuddy export through the native save panel and the English Rules page. The exported ZIP matched all three source files. Later UI observation returned timeout/no-window errors, so a complete English handoff and a new return-to-Chinese pass are not counted. No external client was configured or launched for acceptance.
The assistant reuses Shou scans and receipts, investigating purpose, activity, rebuild cost and retention in largest-first batches. It separates recommendations, unresolved decisions, protected and kept objects. Retention preferences can persist; one deletion approval never covers newly discovered targets. Database, container and virtual-disk work uses actual supported owner operations; unsupported or gated actions return to the owning tool without Shell bypass.
shou skills list --json
shou skills read --skill shou-cleanup-assistant --json
shou skills install --skill shou-cleanup-assistant --agent codex --json
shou skills export --skill shou-cleanup-assistant --output "$HOME/Downloads/shou-cleanup-assistant.zip" --jsonWindows uses the same options with actual absolute Windows paths. Installing a Skill neither performs cleanup nor grants future deletion authority.
The official Lark CLI guide offers npx @larksuite/cli@latest install. Its installation wizard installs the CLI and delegates Skill installation to npx skills add <repository> -y -g. Source installations document npx skills add larksuite/cli -y -g.
Its skills commands also expose skills list and skills read <name> [relative-file]. Instructions and references are embedded at build time, so an agent can read the copy matching that CLI version without locating a source checkout. Reading skills does not require business authentication.
Shou implements the same distribution contract in Swift and C#, shipping shou-cleanup-assistant for disk investigation and shou-rule-authoring for reusable rules. The native installer copies bundled files without requiring Node.js, an account or a network request. Shou has no dependency on Lark CLI or the Skills CLI.
On macOS, use Cleanup Options or Rules → Customize with AI. On Windows, use External AI Tools in Cleanup Options or Settings. Choose Cleanup assistant or Rule authoring and a client, then choose Install Skill or Export Skill ZIP…. Installation writes only the named Skill directory. It does not launch the client or edit its settings files. Copy the prepared request into the client to supply the exact CLI path and chosen workspace.
The same operations are available in the macOS app's independent CLI. Examples elsewhere use shou as shorthand; use this full path when it is not on PATH:
"/Applications/Shou.app/Contents/Helpers/shou" skills install --agent codex --json
"/Applications/Shou.app/Contents/Helpers/shou" skills install --agent claude-code --json
"/Applications/Shou.app/Contents/Helpers/shou" skills export --output "$HOME/Downloads/shou-rule-authoring.zip" --jsonWindows .NET CLI and WinUI Settings/Cleanup Options implement bundled reads, installation and ZIP export. The desktop and CLI are distributed separately: put the standalone CLI on PATH or replace shou in the copied request with its full path. Replace the example directory below with the CLI's actual extraction location. Portable tests do not establish Windows native UI acceptance. Both installers preserve local edits and back up managed updates.
& "C:/path/to/shou-cli/shou.exe" skills install --agent codex --directory "C:/path/to/project/.agents/skills" --json
& "C:/path/to/shou-cli/shou.exe" skills export --output "$env:USERPROFILE/Downloads/shou-rule-authoring.zip" --jsonChoose the relevant command; installing every client is unnecessary.
| Client | Installed location / import | Invocation |
|---|---|---|
| Codex | ~/.agents/skills/shou-rule-authoring/SKILL.md |
$shou-rule-authoring, or a matching natural-language task |
| Claude Code, local session | ~/.claude/skills/shou-rule-authoring/SKILL.md |
/shou-rule-authoring, or a matching natural-language task |
| WorkBuddy | Export ZIP, then Experts · Skills · Connectors → Skills → Add Skill → Upload Skill; enable the imported skill | Start a task asking it to use the Shou rule-authoring skill |
Codex documentation specifies user-level ~/.agents/skills and repository .agents/skills locations. Codex detects changes automatically; restart it if the Skill does not appear. Claude Code documentation specifies ~/.claude/skills and project .claude/skills; local files are not automatically available in a remote environment.
WorkBuddy documentation specifies uploading custom skill packages. Conversation-based installation is for market skills. The reviewed page does not establish a stable user-level automatic-discovery path. WorkBuddy and CodeBuddy are separate products; do not use CodeBuddy's directory or agent identifier as a WorkBuddy contract. ZIP export is implemented; actual WorkBuddy upload acceptance remains pending.
To install for one project, explicitly choose its parent skills directory:
shou skills install --agent codex --directory "/path/to/project/.agents/skills" --json
shou skills install --agent claude-code --directory "/path/to/project/.claude/skills" --json--skill shou-cleanup-assistant|shou-rule-authoring selects the Skill, defaulting to rule authoring for existing callers. The installer appends the selected name; --directory is the parent folder, not the final Skill folder. It refuses symbolic links in the destination path or installed contents. If a client uses a linked skills directory, choose a real directory explicitly or manage the copy through the client's supported installer.
shou skills list --json
shou skills read
shou skills read shou-rule-authoring references/questionnaire.md --json
shou skills read --file references/questionnaire.md --json
shou agent skill --jsonskills read emits the original Markdown by default; --json returns name, file, and content inside the standard envelope. Only the three shipped files are readable: SKILL.md, references/questionnaire.md, and agents/openai.yaml. agent skill additionally returns local directory and entrypoint paths. All these commands work without opening cleanup storage.
As in Lark CLI, named reads accept skills read shou-rule-authoring, a separate relative-file argument, or skills read shou-rule-authoring/references/questionnaire.md. Duplicate positional/flag file selections are rejected. shou skills --help describes only the Skill group; shou capabilities --command skills --json returns its machine contract. Capability discovery also works when cleanup storage is unavailable.
For a client with local file/command access, the desktop's copied request is also usable without installation: ask it to read the bundled SKILL.md. This is an explicit handoff, not a claim of automatic Skill discovery. The exact installed CLI's capabilities, schema and bundled instructions remain authoritative when an installed Skill copy is older.
The app and independent CLI carry the same source Skill. Updating Shou replaces that bundled copy; it does not silently modify installed client copies. Run Install Skill again after an update:
- Identical files return
already_current. - A previous Shou-managed copy with matching recorded digests is moved to a sibling
.shou-rule-authoring-backup-<id>before the new version is installed. - Local modifications, unknown files or unmanaged conflicting content return
version_conflict; existing files are preserved. - ZIP export never overwrites an existing output file.
These checks prevent routine accidental overwrites. They do not isolate Shou from another process with the same filesystem permissions or guarantee immunity to concurrent path changes.
After this Skill has been published to the remote repository, users of the Vercel Skills CLI can choose:
npx skills add limecloud/shou --skill shou-rule-authoring -g -a codex
npx skills add limecloud/shou --skill shou-rule-authoring -g -a claude-codeThese are publication-dependent examples. Local implementation is not evidence that the remote repository contains the new files. The reviewed supported-agent list includes CodeBuddy, but does not establish WorkBuddy support. The bundled installer and ZIP export remain available without this optional tool.
flowchart LR
Source[One Skill source directory] --> Resource[ShouAgentSupport resources]
Resource --> Desktop[Native install and export UI]
Resource --> CLI[Independent skills commands]
Desktop --> Installer[ShouPlatform installer]
CLI --> Installer
Installer --> Local[Codex or Claude Code skills directory]
Installer --> ZIP[ZIP for WorkBuddy upload]
CLI --> Read[Read version-matched instructions]
Local --> Agent[Existing external agent]
ZIP --> Agent
Read --> Agent
Agent --> Public[Public cleanup CLI and schema]
sequenceDiagram
actor User
participant Shou as Desktop or CLI
participant Files as Bundled Skill and client directory
participant Agent as Existing client
User->>Shou: Select client and install, or export ZIP
Shou->>Files: Inspect destination and copy complete Skill
Files-->>Shou: Installed, current, backed-up update, or conflict
Shou-->>User: Location and invocation guidance
User->>Agent: Invoke installed Skill or supply copied request
Agent->>Shou: skills read / capabilities / rules schema
Shou-->>Agent: Current instructions and actual contract
Agent-->>User: Ask unresolved purpose and retention questions
Note over User,Agent: Rule authoring continues through validation and preview
See the rule-authoring workflow and CLI contract. Skill installation changes instructions, not rule enablement or cleanup authorization.