Computer Repair Skill
Guides for diagnosing and repairing Windows, macOS and Linux, from low disk space and network failures to boot problems
- 608 ★ on the repository
- Last commit
- AGPL-3.0
Broad access
Why this level
- The skill steers the agent toward commands that delete, install, elevate privileges, restart and edit services, partitions and the registry, so every confirmation deserves a read
- The audits touch sensitive things: stored credentials, SSH keys, tokens and browser profiles
- The BitLocker, partition and data recovery guides work with boot and disks, and a mistake can cost data
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/computer-repair-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The skill steers the agent toward commands that delete, install, elevate privileges, restart and edit services, partitions and the registry, so every confirmation deserves a read
- The audits touch sensitive things: stored credentials, SSH keys, tokens and browser profiles
- The BitLocker, partition and data recovery guides work with boot and disks, and a mistake can cost data
This is third-party code. Review the repository files before installing.
What it does
Computer Repair Skill gives an agent a diagnostic sequence: identify the system and available tools, collect evidence, compare possible causes and propose a fix. Its instructions call for approval of changes, a rollback plan and verification of the result. The collection contains 64 topical guides covering performance, disks and backups, networking, apps, updates, printers, Windows startup, data recovery and development environments. The agent chooses a guide by symptom and platform; coverage differs across Windows, macOS and Linux. For a full disk, the instructions describe a staged directory inventory with the scan scope stated. After cleanup, they call for separate counts of processed files and space actually freed. Windows app migration has a copy-and-verify procedure that preserves the original path through a Junction. The skill consists of instructions and helper scripts; the selected agent executes commands.
Who it is for. For computer owners, administrators and developers who ask an agent to deal with slowdowns, low disk space, networking, updates and printers and want to confirm every change.
Good fit when
- The Windows C drive is full and you need a size inventory with a risk-graded cleanup plan and no deletions
- An app has to move to another drive with a verified copy and the original path preserved through a Junction
- A printer shows offline, Windows Update fails or a Mac cannot update
- Before handing over or recycling a computer you need to list sensitive data and leftover accounts
- Windows does not boot and before reinstalling you need to learn whether the disk or the bootloader is at fault, with no BIOS changes
Not a fit when
- You want buying advice or a programming answer: the skill excludes general development, software design and purchases
- The client only chats with no access to files and a terminal: it will give manual steps and verify nothing itself
- You want cleanup without consultation: the instructions call for diagnostics, a plan and approval of changes
- You need continuous monitoring: the skill works on request inside an agent session and starts no service
Example request
Windows 11, the C drive is almost full. First only read which groups of files take the most space and give a risk-graded cleanup plan. Delete nothing without my confirmationLimitations
Approval and rollback are instructions, not an independent blocking mechanism. Actual actions are constrained by the client’s permissions and settings. Commands can modify services, files and disks; system logs and details read by the agent may enter a cloud model’s context.
The skill needs no dedicated API, but some tasks require downloads or vendor services. The main documentation is Chinese, and the license is AGPL-3.0. The external skills installer needs Node.js and npm; Python 3.10 and Git are required only by a separate storage-audit script. The repository’s installer leaves an existing folder unchanged without `--force`; with that flag, it first moves the folder to a backup.
How to disable. Delete the computer-repair-skill folder from the agent's skills directory: ~/.codex/skills/, ~/.claude/skills/ or ~/.agents/skills/. When updating through the install script, old versions go to the neighbouring external/computer-repair-skill/backups folder, which you can delete as well.
FAQ
How do I install Computer Repair Skill in Claude Code or Codex?
Run npx skills add 88lin/computer-repair-skill --global --agent claude-code or --agent codex and restart the client. There are other routes: ask the agent to install the skill from the repository link, run scripts/install.sh or scripts/install.ps1 with --target codex, claude or agents, or copy the skills/computer-repair-skill folder by hand.
What does the skill do when the Windows C drive is full?
The instructions call for listing file groups by size and stating scan coverage, then drafting a cleanup plan with the impact of each step. After approved changes, the agent should measure freed space. This is a workflow for the agent; check its permissions before running it.
Can the skill delete files without asking?
Its rules prohibit that, but a skill file does not block commands by itself. Configure the agent to require approval. Before deletion, inspect the file list, backup and rollback options.
Does this skill need a separate program or a paid API?
No. The skill is Markdown and YAML files, uses your agent's terminal and file tools and starts no model of its own. The optional Git storage audit script needs Python 3.10 or newer and Git.
How do I move an app to another drive without breaking it?
The Windows migration guide copies the data with verification and keeps the original path through a Junction, so the program finds its files in the old place. First the agent checks the NTFS file system, free space, process locks and a rollback plan. If the program will not open after the move, a separate guide checks the links.
Discussion
No questions or reviews yet.
Related
SkillsA tutor for any subject: diagnosis, a study plan, project tasks and mastery checks, with the results saved to Markdown files
Readwise skills help agents triage a reading inbox, discuss books and connect highlights across saved sources
A skill set for resumes and job search: tailoring to a vacancy, ATS pass-through checks, cover letters and interview preparation
A personal set of six skills: goal briefs for an agent, disk cleanup, AI news digests, project tidy-up, deep research and long-form writing
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
A Windows skill that analyzes drive C across 12 categories and builds a report and a staged cleanup plan.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Computer Repair Skill (this card) | no | 608 | ||
| Keep Codex Fast | no | 1,602 | maintains only Codex's own local state | |
| WinUtil CN MCP | no | not required | 1,054 | an MCP server for Windows with a catalog of programs and tweaks, installation goes through it |
README in short
Version 1.3.0 separates topical guides from shared diagnostic and access policies. For WinRE or installation media, the instructions suggest saving a checklist in advance rather than assuming an agent or network will be available there.
README badge
Original SKILL.md
--- name: computer-repair-skill description: Use this skill when a user asks to diagnose, repair, clean up, recover, migrate, configure, secure, or maintain a Windows, macOS, or Linux computer. It covers system drives, app or data migration to another drive, slow or unstable machines, storage, apps, updates, networking, printers, backups, credentials, drivers, hardware, startup/WinRE, BitLocker, partitions, data recovery, developer tools, and OpenClaw setup. Do not use for general programming, software design, buying advice, or questions that do not require inspecting or changing a computer. when_to_use: 典型请求：C 盘变红/爆满、电脑卡顿、开机很慢、流氓软件、弹窗广告、突然断网、Windows 更新失败、打印机离线、把微信或应用迁到 D 盘、误删文件找回、蓝屏进不了系统、新机验收、OpenClaw 装不上。 version: 1.3.0 --- <!-- Keep the description below the validator's 80-word/600-character limits so future edits retain headroom. --> # Computer Repair Skill ## 目标 把宿主 Agent 作为推理层，把本机文件、终端和网络工具作为执行层。直接诊断并处理电脑问题，先用证据定位原因，再提出最小修复，获得确认后执行并验证。 本 Skill 不启动独立模型、不调用专用云端 API，也不依赖配套桌面应用。始终服从宿主 Agent 的沙箱、权限和审批机制。 ## 执行前检查 1. 识别实际操作系统、Shell、当前权限和可用工具。不要仅凭用户描述推断平台。 2. 确认目标作用于本机或用户明确指定的设备。保留用户给出的路径、备份、迁移、保留数据等约束。 3. 判断宿主是否具有本机执行能力。具备时直接运行诊断；仅有聊天能力时提供带验证点的人工步骤。 若目标已经进入 PE、WinRE 或安装介质等离线环境，先在宿主仍可用时保存检查清单和证据；不要假设离线环境内有网络或 AI。 4. 选择当前平台参考，只读取一份： - Windows：读取 [tools-windows.md](references/tools-windows.md) - macOS：读取 [tools-macos.md](references/tools-macos.md) - Linux：读取 [tools-linux.md](references/tools-linux.md) 5. 遇到 Playbook 语义工具名时，读取 [tool-contract.md](references/tool-contract.md) 并转换为宿主工具或平台命令。 6. 任务涉及清理、卸载残留、启动项、服务、计划任务、浏览器扩展、文件关联或缓存时，先读取 [cleanup-protocol.md](references/cleanup-protocol.md)；如果规则来自外部数据库、用户自定义文件或远程仓库，再读取 [rule-source-contract.md](references/rule-source-contract.md)。 ## 强制工作流 ### 1. 明确目标 - 将用户请求拆成症状、目标状态和不可改变的约束。 - 用户同时提出多个目标时逐项保留，不要用删除替代迁移、用重装替代修复或跳过明确要求。 - 只有歧义会显著改变执行路径时才提问；其余情况先做快速只读检查。 - 将动作分为：只读审计、可逆变更、高影响变更和系统级红线。高影响动作逐项确认，系统级红线停止并转向厂商或企业恢复路径。 ### 2. 路由 Playbook - 读取 [playbook-index.md](references/playbook-index.md)，按症状、平台和触发词选择最具体的 Playbook。 - 只加载当前任务需要的 `references/playbook-*.md`。不要一次读取全部 Playbook。 - 优先选择精确 Playbook；多个问题确实独立时按影响和依赖顺序逐个执行。 - 对含 `## Step N:` 的程序型 Playbook，按编号顺序推进并维护当前步骤。对诊断型 Playbook，沿其检查树执行。