Agent skill

Im Contact Sorter

by cafe3310 in cafe3310/public-agent-skills

“批量整理、分类和清洗即时通讯 (IM) 软件联系人与群组的结构化工作流工具”

— description from SKILL.md by cafe3310
Apache-2.0Auto-check passed

Install Im Contact Sorter

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill im-contact-sorter -a claude-code

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

GitHub CLI
$ gh skill install cafe3310/public-agent-skills im-contact-sorter --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/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_parked/im-contact-sorter .claude/skills/im-contact-sorter && 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
im-contact-sorter
GitHub stars
255
Token cost
~560 tokens
SKILL.md length
143 words
Files
6 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 6 steps: 准备与裁切 (Crop) → 压缩 (Compress) → 识别 (OCR) → …
  • SKILL.md covers 核心概念, 目录规范 and 工作流程
  • Runs Python scripts from its folder; calls python

About this skill

Im Contact Sorter is a skill in cafe3310/public-agent-skills (255 stars). Its SKILL.md is about 560 tokens, with 5 other files in the folder (scripts). Licence: Apache-2.0.

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 准备与裁切 (Crop)
  2. 压缩 (Compress)
  3. 识别 (OCR)
  4. 合并 (Merge)
  5. 分类与分析 (Classify & Analyze)
  6. 闭环清理 (Action)

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. 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 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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

Im Contact Sorter loads about 560 tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 143 words of instructions outside code blocks.

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

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 cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 143 words, ~560 tokens.

Download SKILL.mdSave it as .claude/skills/im-contact-sorter/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
im-contact-sorter
description
批量整理、分类和清洗即时通讯 (IM) 软件联系人与群组的结构化工作流工具
license
Apache-2.0
author
github/cafe3310
depends_on_binary
python3

IM Contact Sorter

此技能提供了一套标准化的流水线,帮助用户将缺少分类功能的 IM 软件中的联系人和群组进行整理。 整体思路是,通过界面截图 - OCR 识别 - 合并和分析,最终形成结构化的数据资产,并辅助进行清理和归档。

核心概念

  • Everything (全集): 包含所有联系人/群组的基础列表(通常来自原始截图的ocr)。
  • Primary Category (一级分类): 粗颗粒度的分类,如“所有联系人”、“所有群组”。
  • Secondary Category (二级分类): 细颗粒度的分类,如“重要群组”、“高价值讨论”。
  • Funnel Analysis (漏斗分析): 通过对比全集与各级分类,找出“未分类”和“分类不完全”的项目。

目录规范

使用此技能时,请在工作目录中遵循以下生命周期:

  1. 01-raw: 存放原始截图 (用户输入)。
  2. 02-cropped: 存放裁切和压缩后的图片 (脚本生成)。
  3. 03-ocr: 存放 OCR 识别后的 YAML 片段 (LLM生成)。
  4. 04-merged: 存放合并后的分类文件 (脚本生成)。
  5. 05-classified: 人工调整分类的工作区 (用户操作)。
  6. 06-report: 存放分析报告与操作建议 (脚本生成)。

工作流程

1. 准备与裁切 (Crop)

首先,用户将截图,按已有的分类文件夹放入 01-raw。例如 01-raw/everything,01-raw/working-groups 等。

然后,询问用户裁切参数 (左,上,宽,高),以去除无关 UI 元素,只保留联系人列表区域。使用以下命令裁切图片:

bash
# 用法: python crop.py <工作目录> <子目录名> <左> <上> <宽> <高>
# 示例: 裁切 'everything' 文件夹中的图片
python <path/to/skill>/scripts/crop.py . "everything" 0 200 1000 2000

你需要为每个子目录重复此步骤,直到所有截图均裁切完成,结果保存在 02-cropped/<子目录> 中。

2. 压缩 (Compress)

对图片进行原地压缩,减少传输体积。你需要为每个子目录执行以下命令:

bash
# 用法: python compress.py <工作目录> <子目录名>
python <path/to/skill>/scripts/compress.py . "everything"
3. 识别 (OCR)

使用多模态模型识别 02-cropped 中的图片。这一步的 prompt 在 scripts/ocr.md 中定义,读取并执行它。

将结果保存到 03-ocr/<子目录>/<文件名>.yaml。

4. 合并 (Merge)

将碎片化的 YAML 合并为完整文件。

bash
# 用法: python merge.py <工作目录>
python <path/to/skill>/scripts/merge.py .

此步将在 04-merged 中生成如 everything.yaml 的汇总文件。

5. 分类与分析 (Classify & Analyze)
  1. 人工分类: Agent 需要将 04-merged 的内容复制到 05-classified。提醒用户,可以根据需要调整分类结构。

  2. Agent 分析:

bash
# 用法: python analyze.py <工作目录>
python <path/to/skill>/scripts/analyze.py .

脚本将:

  • 扫描 05-classified 中的 everything 文件,注入 groups 属性,识别每个项目所属的群组分类。
  • 对比 everything 与各二级分类,识别未分类的项目。
  • 生成 06-report/uncategorized_people.yaml (全局漏斗:未分类的人)。
  • 生成 06-report/uncategorized_groups.yaml (全局漏斗:未分类的群)。
6. 闭环清理 (Action)

根据 06-report 中的报告:

  1. 清理: 对未分类且无价值的项目,在 IM 软件中删除。
  2. 归档: 对未分类但有价值的项目,手动加入正确的二级分类。

© cafe3310, Apache-2.0. 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 5 other files (scripts) in skills_parked/im-contact-sorter of cafe3310/public-agent-skills.

  • SKILL.md
  • scripts/analyze.py
  • scripts/compress.py
  • scripts/crop.py
  • scripts/merge.py
  • scripts/ocr.md

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Im Contact Sorter 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.

Im Contact Sorter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Im Contact Sorter this skillcafe3310/public-agent-skills255—~560Automated safety check: PassApache-2.0
Contact Pagethedaviddias/Front-End-Checklist74k—~424Automated safety check: PassMIT
Contact Widgetnexu-io/open-design100k—~1.6kAutomated safety check: PassApache-2.0
Mailtrap Managing Contactssickn33/agentic-awesome-skills47k1 repos~1.9kAutomated safety check: PassMIT
Contactsvellum-ai/vellum-assistant1.4k—~8.9kAutomated safety check: PassMIT
Recipe Sync Contacts To Sheetgoogleworkspace/cli31k—~249Automated safety check: PassApache-2.0

Similar skills

  • Contact Page

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Create a comprehensive Contact page.

    74k GitHub stars~424 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Contact Widget

    nexu-io/open-design

    Self-contained floating chat widget with welcome screen, social links, meeting button, and message input.

    100k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Mailtrap Managing Contacts

    sickn33/agentic-awesome-skills

    Manage Mailtrap contacts, lists, segments, custom fields, imports, CRM syncs, and campaign audiences through the UI or API.

    47k GitHub starsUsed in 1 repo~1.9k tokens
    Sales & SupportAuto-check passed
  • Contacts

    vellum-ai/vellum-assistant

    Manage contacts, communication channels, access control, and invite links

    1.4k GitHub stars~8.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Export Google Contacts directory to a Google Sheets spreadsheet.

    31k GitHub stars~249 tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • Contact Sync

    gnekt/My-Brain-Is-Full-Crew

    Sync a person to Apple Contacts. An agent skill from gnekt/My-Brain-Is-Full-Crew.

    3.9k GitHub stars~2k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: warnings

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Obsidian Todo Collector

    cafe3310/public-agent-skills

    从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~575 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Im Contact Sorter

How do I install Im Contact Sorter in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill im-contact-sorter -a claude-code`. Or copy the skill folder (skills_parked/im-contact-sorter in cafe3310/public-agent-skills) into .claude/skills/im-contact-sorter in your project. Claude Code loads it when a task matches its description.

How do I install Im Contact Sorter in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill im-contact-sorter -a codex`. Or copy the skill folder (skills_parked/im-contact-sorter in cafe3310/public-agent-skills) into .agents/skills/im-contact-sorter in your project. Codex loads it when a task matches its description.

Can I use Im Contact Sorter 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 cafe3310/public-agent-skills --skill im-contact-sorter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/im-contact-sorter, .gemini/skills/im-contact-sorter, .github/skills/im-contact-sorter and .opencode/skills/im-contact-sorter in your project.

What does Im Contact Sorter need to run?

Going by SKILL.md and its folder, Im Contact Sorter needs Python for the scripts in its folder and the command-line tools its instructions call (python).

Does Im Contact Sorter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Im Contact Sorter 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 Im Contact Sorter use?

Im Contact Sorter is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Im Contact Sorter use?

About 560 tokens (SKILL.md is roughly 2.2k 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 Im Contact Sorter?

Skills that share tags, products or a category with Im Contact Sorter: Contact Page (thedaviddias/Front-End-Checklist, 74k stars), Contact Widget (nexu-io/open-design, 100k stars), Mailtrap Managing Contacts (sickn33/agentic-awesome-skills, 47k stars) and Contacts (vellum-ai/vellum-assistant, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Im Contact Sorter?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

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