About cat-kit
cat-kit is a TypeScript toolkit collection for browser and Node.js projects, with a skill that guides selection of its public APIs. It helps developers reuse existing packages by environment and task instead of adding overlapping utilities.
Key features
- 01Packages for browser and Node.js
- 02Utilities for data, dates, and execution control
- 03HTTP client and cryptographic identifiers
- 04Browser storage, files, and clipboard utilities
- 05Node.js filesystem, logging, cache, and scheduling
Use cases
- 01Choose an existing package for a project task
- 02Reuse common data and date utilities
- 03Add browser file or storage operations
- 04Handle Node.js configuration, logs, or scheduled jobs
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/cat-kitin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
generated/agent-context/cli.d.tsmanifest.jsonREADME.mdgenerated/be/index.d.tsmanifest.jsonREADME.mdgenerated/be/cache/file-cache.d.tslru-cache.d.tsmemoize.d.tsgenerated/be/config/config.d.tsenv.d.tsmerge.d.tsgenerated/be/fs/empty-dir.d.tsensure-dir.d.tsindex.d.tsjson.d.tsmove.d.tsread-dir.d.tsremove.d.tswrite-file.d.tsgenerated/be/logger/logger.d.tstransports.d.tsgenerated/be/net/ip.d.tsport.d.tsgenerated/be/scheduler/cron.d.tsscheduler.d.tsgenerated/be/system/cpu.d.tsdisk.d.tsmemory.d.tsnetwork.d.tsDetails
From the project READMEcat-kit
喵喵工具箱：面向浏览器与 Node.js 的 TypeScript 工具包集合。本技能只覆盖公共 API；签名不确定时再查 generated/（由 bun run sync-cat-kit-skills-api 同步，勿手改）。
决策顺序
- 检查宿主项目已有的
@cat-kit/*依赖、运行环境与代码约定。 - 按下方路由匹配公开 API，优先复用已有包。
- 目标包缺失时只建议完成任务所需的最小包，并在变更依赖前遵循宿主项目的确认规则。
- 现有公开能力不匹配时，再自行实现或选择其他依赖；不要把业务专用逻辑强行套入通用工具。
先读一个最相关的主题 index.md；确需多 API 组合时再读该主题或包级 examples.md；仅在签名不确定时读对应 generated 声明。不要预读整个 packages/ 或 generated/。
所有代码只从包根或文档明确给出的公开子路径导入，不引用 src、dist 深路径或未导出符号。
版本
| 包 | 版本 |
|---|---|
@cat-kit/core | 1.1.8 |
@cat-kit/http | 1.1.8 |
@cat-kit/crypto | 1.0.0 |
@cat-kit/fe | 1.1.8 |
@cat-kit/be | 1.1.8 |
@cat-kit/cli | 1.0.6 |
@cat-kit/agent-context | 2.0.3 |
@cat-kit/tsconfig | 2.0.1 |
@cat-kit/vitepress-theme | 1.0.2 |
分包地图
| 包 | 场景 |
|---|---|
| core | 通用数据、日期、环境、树、执行控制（零依赖） |
| http | HTTP 客户端与插件 |
| crypto | 安全随机 ID / 字节 |
| fe | 浏览器：虚拟列表、补间、文件、存储、剪贴板 |
| be | Node.js：FS、配置、日志、缓存、网络、系统、调度 |
| cli | cat-cli verify-commit |
| agent-context | Agent 协作 CLI 与协议 |
| tsconfig | TypeScript 预设 |
| vitepress-theme | VitePress 主题 |
常见替代
动手封装或引入 lodash / axios / dayjs / nanoid 前，优先对照本表：
| 常见写法 / 依赖 | 优先使用 |
|---|---|
cloneDeep / structuredClone | copy（@cat-kit/core） |
| axios | @cat-kit/http |
| dayjs | date()（@cat-kit/core） |
| nanoid | @cat-kit/crypto |
lodash debounce / throttle | debounce / throttle（@cat-kit/core） |
路由决策
通用数据与流程
- 深拷贝、克隆任意值、cloneDeep、structuredClone、Vue 响应式快照 → core/any
- 数组去重、尾元素、对象挑选/合并 → core/array-object
- 字符串命名转换、URL 路径、类型守卫 → core/string-type
- 字节/十六进制/Base64/查询串、schema 校验 → core/transform-validation
- 小数运算、表达式、货币与精度格式化 → core/number
- 日期格式化、解析、加减、区间 → core/date
- 运行时 / OS / 浏览器 / 设备探测 → core/env
- 树/森林遍历与节点关系 → core/data-structure
- 防抖、节流、延时、限并发、安全同步执行 → core/optimize
- 浅层状态观察 → core/pattern
- 多主题组合 → core/examples
网络与随机标识
- HTTP 客户端、响应、错误、引擎 → http/client
- Token 刷新、方法覆盖、自定义插件 → http/plugins
- 安全随机 ID → crypto/nanoid
浏览器
- 虚拟列表 → fe/virtualizer
- 补间动画 → fe/tween
- 分块读取 / 下载 → fe/file
- Web Storage / Cookie → fe/storage
- 剪贴板与权限查询 → fe/web-api
- 多主题组合 → fe/examples
Node.js
- 目录遍历、读写、移动、删除 → be/fs
- 日志 → be/logger
- LRU / 文件缓存 / 记忆化 → be/cache
- 环境变量与配置加载 → be/config
- 端口与本机 IP → be/net
- CPU / 内存 / 磁盘 / 网卡 → be/system
- Cron 与定时任务 → be/scheduler
- 多主题组合 → be/examples
- 提交信息校验 → cli
- Agent CLI 安装/状态 → agent-context/cli
- Agent 协议动作 → agent-context/protocols
- Agent 端到端流程 → agent-context/examples
工程配置
- TS 预设 → tsconfig
- VitePress 主题入口 → vitepress-theme/theme
- VitePress 配置助手 → vitepress-theme/config
- VitePress 接入示例 → vitepress-theme/examples
检查清单
- 已确认宿主环境（浏览器 / Node / Bun）与目标包匹配
- 拟用符号可从包根（或文档标明的公开子路径）导入
- 依赖版本与上方版本表一致，或已对照 CHANGELOG
- 未引用
src/dist深路径、@internal或未导出符号 - 签名不确定时已查阅
generated/<pkg>/，而非猜测 - 刷新类型声明：仓库根执行
bun run sync-cat-kit-skills-api（或:build）
Comments
Markdown supported