Agent skill

Tidymydesktop

by peterfei in peterfei/ai-agent-team

智能桌面和目录整理工具。根据用户提示词自动分类、整理文件和应用程序图标,去除重复版本,生成整理报告。支持整理桌面或指定目录。

MITAuto-check passedDocuments & Office

Install Tidymydesktop

skills CLI
$ npx skills add peterfei/ai-agent-team --skill tidymydesktop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install peterfei/ai-agent-team tidymydesktop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/peterfei/ai-agent-team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tidymydesktop .claude/skills/tidymydesktop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tidymydesktop
GitHub stars
441
Token cost
~1.2k tokens
SKILL.md length
286 words
Files
23 (incl. scripts)
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

智能桌面和目录整理工具。根据用户提示词自动分类、整理文件和应用程序图标,去除重复版本,生成整理报告。支持整理桌面或指定目录。

  • Works in 5 steps: 分析目录中的文件和应用程序 → 智能分类并创建文件夹 → 识别和删除软件的旧版本 → …
  • Documents & Office work in your project
  • SKILL.md covers 概述, 支持的触发指令, 工作流程 and 工具脚本使用说明, plus 6 more sections
  • Runs JavaScript, Batch and Shell scripts from its folder; calls node, npm and nvm

What it does

Tidymydesktop is an agent skill from peterfei/ai-agent-team. 智能桌面和目录整理工具。根据用户提示词自动分类、整理文件和应用程序图标,去除重复版本,生成整理报告。支持整理桌面或指定目录。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 23 other files, including scripts (for example `CHANGELOG.md`, `README.md` and `TEST_REPORT.md`).

It sits in Documents & Office. The repository describes itself as: AI Agent Team-拥有24/7专业AI开发团队:产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人。一键安装,支持中英文命令,大幅提升开发效率!. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/tidymydesktop”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 分析目录中的文件和应用程序
  2. 智能分类并创建文件夹
  3. 识别和删除软件的旧版本
  4. 搜索未知软件的用途
  5. 生成详细的整理报告(Markdown格式)

What it can do on your machine

Read from SKILL.md and the folder at commit 9d85024. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 6 files in scripts/ (JavaScript, Batch and Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm
    • nvm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tidymydesktop loads about 1.2k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from peterfei/ai-agent-team at commit 9d85024, republished under its MIT licence (© peterfei). 286 words, ~1,248 tokens.

Download SKILL.mdSave it as .claude/skills/tidymydesktop/SKILL.md (or your agent's skills folder). This skill also uses 22 other files; get the full folder from GitHub.
name
tidymydesktop
description
智能桌面和目录整理工具。根据用户提示词自动分类、整理文件和应用程序图标,去除重复版本,生成整理报告。支持整理桌面或指定目录。
license
MIT

TidyMyDesktop - 智能桌面整理工具

概述

当用户请求整理桌面或目录时,此 skill 会自动:

  1. 分析目录中的文件和应用程序
  2. 智能分类并创建文件夹
  3. 识别和删除软件的旧版本
  4. 搜索未知软件的用途
  5. 生成详细的整理报告(Markdown格式)

支持的触发指令

用户可以通过以下方式触发此 skill:

  • "帮我整理桌面" - 整理 ~/Desktop
  • "帮我整理当前目录" - 整理当前工作目录(需要用户确认)
  • 任何关键词 - 首先搜索相关内容

工作流程

步骤 1: 理解用户意图

首先判断用户输入的类型:

javascript
// 检查是否是整理指令
if (用户输入包含 "整理桌面") {
  目标路径 = ~/Desktop
} else if (用户输入包含 "整理当前目录") {
  // 需要用户确认目录路径
  await askUserToConfirmPath()
} else {
  // 如果是关键词,先搜索相关内容
  await searchKeyword(用户输入)
  return
}
步骤 2: 扫描和分析目录

使用提供的 Node.js 工具脚本扫描目标目录:

bash
# 扫描目录并生成文件清单
node ~/.claude/skills/tidymydesktop/scripts/scan.js <目标路径>

该脚本会:

  • 列出所有文件和应用程序
  • 识别文件类型和扩展名
  • 检测应用程序版本号
  • 生成初始清单
步骤 3: 智能分类和整理

执行整理操作时,遵循以下原则:

3.1 文件分类规则

根据文件类型创建分类文件夹:

  • 应用程序 (Applications/)

    • 开发工具 (Development/)
    • 办公软件 (Office/)
    • 设计工具 (Design/)
    • 通讯工具 (Communication/)
    • 娱乐软件 (Entertainment/)
    • 系统工具 (Utilities/)
  • 文档 (Documents/)

    • PDF文档 (PDFs/)
    • Word文档 (Word/)
    • Excel表格 (Excel/)
    • 文本文件 (TextFiles/)
  • 图片 (Images/)

    • 照片 (Photos/)
    • 截图 (Screenshots/)
    • 设计稿 (Designs/)
  • 视频 (Videos/)

  • 音频 (Audio/)

  • 压缩包 (Archives/)

  • 代码项目 (CodeProjects/)

  • 未分类 (Uncategorized/)

3.2 版本去重规则

对于同一软件的多个版本:

javascript
// 识别版本号模式
// 例如: "AppName v1.2.3.dmg" 和 "AppName v2.0.0.dmg"
// 保留: 最新版本
// 删除: 旧版本

function identifyVersions(files) {
  // 1. 提取版本号
  // 2. 比较版本
  // 3. 标记要删除的旧版本
}

CRITICAL: 在删除任何文件前,必须:

  1. 向用户展示将被删除的文件列表
  2. 等待用户确认
  3. 获得明确同意后才执行删除操作
3.3 未知软件处理

当遇到不确定用途的软件时:

bash
# 使用 WebSearch 搜索软件信息
# 搜索查询格式: "<软件名称> 是什么软件 用途"

如果搜索后仍不确定:

  • 将其放入 未分类/ 文件夹
  • 在报告中标注为"需要人工审核"
步骤 4: 执行整理操作

使用提供的整理脚本:

bash
# 执行整理操作
node ~/.claude/skills/tidymydesktop/scripts/organize.js \
  --source <目标路径> \
  --plan <整理计划JSON文件> \
  --dry-run  # 首次运行使用 dry-run 模式

重要安全措施:

  1. 首次运行使用 --dry-run 模式(仅模拟,不实际移动文件)
  2. 向用户展示整理计划
  3. 获得用户确认后,再执行实际操作
  4. 所有删除操作都需要用户明确确认
步骤 5: 生成整理报告

创建详细的 Markdown 报告,包含:

markdown
# 桌面整理报告

**整理时间**: YYYY-MM-DD HH:MM:SS
**整理路径**: /Users/xxx/Desktop

## 整理概要

- 总文件数: XXX
- 已分类文件: XXX
- 创建的文件夹: XXX
- 删除的重复文件: XXX
- 未分类文件: XXX

## 分类详情

### 应用程序 (XX 个)
- 开发工具 (XX 个)
  - Visual Studio Code
  - IntelliJ IDEA
  - ...

### 文档 (XX 个)
- PDF文档 (XX 个)
- ...

## 版本去重记录

| 软件名称 | 保留版本 | 删除版本 | 状态 |
|---------|---------|---------|------|
| Example App | v2.0.0 | v1.0.0, v1.5.0 | 已删除 |

## 未知软件

| 文件名 | 搜索结果 | 处理方式 |
|-------|---------|---------|
| Unknown.app | 未找到相关信息 | 放入"未分类"文件夹 |

## 建议

- [可选] 进一步整理建议
- [可选] 可能需要手动审核的项目

报告保存位置:

  • 桌面整理: ~/Desktop/整理报告_YYYYMMDD_HHMMSS.md
  • 目录整理: <目标路径>/整理报告_YYYYMMDD_HHMMSS.md

工具脚本使用说明

scan.js - 目录扫描工具

扫描目录并生成文件清单:

bash
node ~/.claude/skills/tidymydesktop/scripts/scan.js <目标路径>

输出 JSON 格式的文件清单。

organize.js - 整理执行工具

根据整理计划执行文件移动和删除操作:

bash
# Dry-run 模式(推荐首次使用)
node ~/.claude/skills/tidymydesktop/scripts/organize.js \
  --source <目标路径> \
  --plan <整理计划.json> \
  --dry-run

# 实际执行
node ~/.claude/skills/tidymydesktop/scripts/organize.js \
  --source <目标路径> \
  --plan <整理计划.json>
classify.js - 智能分类工具

使用 AI 辅助分类未知文件:

bash
node ~/.claude/skills/tidymydesktop/scripts/classify.js \
  --file <文件路径> \
  --search  # 启用网络搜索

使用示例

示例 1: 整理桌面

用户: "帮我整理桌面"

Claude 执行流程:

  1. 识别触发词 "整理桌面"
  2. 设置目标路径为 ~/Desktop
  3. 运行扫描工具
  4. 生成分类计划
  5. 以 dry-run 模式预览整理结果
  6. 向用户展示整理计划
  7. 等待用户确认
  8. 执行实际整理操作
  9. 生成并保存整理报告
  10. 向用户展示报告摘要
示例 2: 整理当前目录

用户: "帮我整理当前目录"

Claude:

"我将整理当前目录。请确认目标路径:/Users/xxx/Downloads

是否继续?(yes/no)"

用户: "yes"

Claude 执行流程: (与示例 1 相同的流程)

示例 3: 关键词搜索

用户: "VS Code"

Claude 执行流程:

  1. 识别为关键词(非整理指令)
  2. 使用 WebSearch 搜索 "VS Code"
  3. 返回搜索结果
  4. 不执行整理操作

安全注意事项

  1. 永远不要自动删除文件 - 所有删除操作必须经过用户明确确认
  2. 使用 dry-run 模式 - 首次整理时始终使用模拟模式
  3. 备份提醒 - 在执行重要操作前提醒用户备份
  4. 路径确认 - 整理目录时必须让用户确认路径
  5. 版本识别准确性 - 版本号识别可能不准确,标记为"待确认"

依赖项

Node.js 包(通过 nvm 管理):

  • fs-extra - 文件系统操作
  • glob - 文件匹配
  • semver - 版本号比较
  • commander - 命令行参数解析

安装依赖:

bash
# 使用 nvm 切换到合适的 Node 版本
nvm use 18

# 安装依赖
cd ~/.claude/skills/tidymydesktop
npm install

限制和注意事项

  1. macOS 特定功能:

    • .app 应用程序包识别
    • Finder 标签和颜色(暂不支持)
  2. 不支持的操作:

    • 移动系统文件
    • 整理受保护的目录
    • 修改文件内容
  3. 性能考虑:

    • 大型目录(>1000个文件)可能需要较长时间
    • 网络搜索会增加处理时间

故障排除

脚本执行失败
bash
# 检查 Node.js 版本
node --version  # 应该 >= 14.0.0

# 检查依赖安装
cd ~/.claude/skills/tidymydesktop
npm list
权限错误

某些目录可能需要额外权限。如果遇到权限问题:

  • 检查目标目录的读写权限
  • 避免整理系统目录
  • 使用用户目录(如 ~/Desktop, ~/Downloads)

开发和扩展

要添加新的文件分类规则,编辑 scripts/classify.js:

javascript
const CATEGORY_RULES = {
  // 添加新的分类规则
  'NewCategory': {
    extensions: ['.ext1', '.ext2'],
    keywords: ['keyword1', 'keyword2'],
    subfolder: 'NewCategory'
  }
}

版本: 1.0.0 作者: Claude AI 许可: MIT

© peterfei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 22 other files (scripts) in .claude/skills/tidymydesktop of peterfei/ai-agent-team.

  • SKILL.md
  • .npmignore
  • .test-summary.txt
  • CHANGELOG.md
  • LICENSE
  • README.md
  • TEST_REPORT.md
  • package-lock.json
  • package.json
  • scripts/classify.js
  • scripts/organize.js
  • scripts/run.bat
  • scripts/run.js
  • scripts/run.sh
  • scripts/scan.js
  • test.bat
  • test.sh
  • tidy-classify
  • tidy-classify.bat
  • tidy-organize
  • … and 3 more

Open the folder on GitHubat commit 9d85024

Compare with similar skills

Tidymydesktop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tidymydesktop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tidymydesktop this skillpeterfei/ai-agent-team441—~1.2kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from peterfei/ai-agent-team

All 10 skills in this repo
  • Drawnote Skill

    peterfei/ai-agent-team

    智能笔记与流程图绘制工具(优化版-无权限读取)。根据用户提供的内容,自动生成精美的可视化笔记和流程图,支持多种风格(手写笔记、思维导图、流程图等),并导出为图片。使用内置模板,无需读取文件权限。适用于:(1) 学习笔记可视化,(2) 知识梳理与总结,(3) 流程图绘制,(4) 概念解释图表

    441 GitHub stars~2.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Softcopyright

    peterfei/ai-agent-team

    智能软件著作权申请材料生成工具。自动分析项目源码,生成符合软著申请要求的软件说明书和源代码文档。支持关键词搜索、智能源码分析、格式化输出和PDF导出。

    441 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Backend Dev Agent

    peterfei/ai-agent-team

    后端开发 Agent — API 设计、数据库优化、服务器端逻辑、认证授权、性能优化. An agent skill from peterfei/ai-agent-team.

    441 GitHub stars~966 tokensUpdated 3 mo ago
    Auto-check passed
  • Changelog Generator

    peterfei/ai-agent-team

    智能变更日志生成器 - 自动分析Git提交历史,生成符合规范的CHANGELOG.md。支持语义化版本管理、多种输出格式、增量更新和GitHub/GitLab集成。

    441 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Devops Engineer Agent

    peterfei/ai-agent-team

    DevOps 工程师 Agent — CI/CD 流水线、容器化与 K8s、基础设施即代码、可观测性. An agent skill from peterfei/ai-agent-team.

    441 GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed
  • Tech Leader Agent

    peterfei/ai-agent-team

    技术负责人 Agent — 技术架构决策、代码审查、团队技术管理、技术规划与路线图. An agent skill from peterfei/ai-agent-team.

    441 GitHub stars~845 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Tidymydesktop

What does Tidymydesktop do?

智能桌面和目录整理工具。根据用户提示词自动分类、整理文件和应用程序图标,去除重复版本,生成整理报告。支持整理桌面或指定目录。. Tidymydesktop is an agent skill from peterfei/ai-agent-team.

When should I use Tidymydesktop?

Tidymydesktop fits situations like: documents & Office work in your project.

How do I install Tidymydesktop in Claude Code?

Run `npx skills add peterfei/ai-agent-team --skill tidymydesktop -a claude-code`. Or copy the skill folder (.claude/skills/tidymydesktop in peterfei/ai-agent-team) into .claude/skills/tidymydesktop in your project. Claude Code loads it when a task matches its description.

How do I install Tidymydesktop in Codex?

Run `npx skills add peterfei/ai-agent-team --skill tidymydesktop -a codex`. Or copy the skill folder (.claude/skills/tidymydesktop in peterfei/ai-agent-team) into .agents/skills/tidymydesktop in your project. Codex loads it when a task matches its description.

Can I use Tidymydesktop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add peterfei/ai-agent-team --skill tidymydesktop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tidymydesktop, .gemini/skills/tidymydesktop, .github/skills/tidymydesktop and .opencode/skills/tidymydesktop in your project.

What does Tidymydesktop need to run?

Going by SKILL.md and its folder, Tidymydesktop needs JavaScript, Windows cmd and a shell for the scripts in its folder and the command-line tools its instructions call (node, npm and nvm). Our summary lists: Node.js; A Bash shell.

Does Tidymydesktop access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Tidymydesktop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tidymydesktop use?

Tidymydesktop is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tidymydesktop use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tidymydesktop?

Skills that share tags, products or a category with Tidymydesktop: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tidymydesktop?

peterfei (a GitHub user) maintains it in peterfei/ai-agent-team, which has 441 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on June 29, 2026.

Source: peterfei/ai-agent-team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.