by study8677
Turn your local Claude Code / Codex CLI history into a shareable, anonymized AI-Native developer profile + viral SVG poster. A skill, not a script — 100% local & read-only.
# Add to your Claude Code skills
git clone https://github.com/study8677/Readme.skillLast scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:24:23.425Z",
"npmAuditRan": true,
"pipAuditRan": true
}Readme.skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by study8677. Turn your local Claude Code / Codex CLI history into a shareable, anonymized AI-Native developer profile + viral SVG poster. A skill, not a script — 100% local & read-only. It has 149 GitHub stars.
Yes. Readme.skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/study8677/Readme.skill" and add it to your Claude Code skills directory (see the Installation section above).
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Readme.skill against similar tools.
No comments yet. Be the first to share your thoughts!
读取本地 Claude Code / Codex CLI / Kiro / Trae / Gemini Antigravity / Cursor 的真实使用数据,自动生成对外可分享、默认脱敏的 AI-Native 开发者画像 —— 一份长报告 + 一张竖屏海报。
🌐 中文 · English | 📥 安装 · 🎬 看效果 · ❓ FAQ · 🗺️ Roadmap
2026-05、2026-03 到 2026-05、最近30天,看某个阶段 AI 编码带来的效果和变化。gh 拉你自己的 GitHub 公开贡献外,0 联网、0 上传、0 写盘到 ~/.claude。Private Repo X,API key / token / 邮箱按 OWASP 正则清洗。| 你是 | 你能用它做什么 |
|---|---|
| 正在求职的开发者 | 在 GitHub profile 顶部放一张你跟 AI 协作的真实画像,比简历的 "熟练使用 AI 工具" 强 100 倍 |
| AI-Native 实践派 | 量化展示你的 cache leverage、多模型编排、自建 skill 数 —— 这些数字用面试讲不出来 |
| 年终复盘 / 月报 / 周报困难户 | 跑一次,得到全量或指定月份的活跃热力图 + Evolution 曲线,复盘材料一键齐 |
| 小红书 / 推特 / 微信 创作者 | 海报内置传播 3 件套(金句 + 徽章 + 安装 CTA),转发链路天然形成 |
| 团队 Tech Lead | 让团队每人跑一份,了解大家的 AI 协作深度,找 best practice 而不是 best worker |
在 Claude Code 里:
/plugin marketplace add study8677/Readme.skill
/plugin install readme-skill@study8677
Claude Code 自动发现 skills/readme-skill/SKILL.md 并挂载,无需手动 symlink。
git clone https://github.com/study8677/Readme.skill.git
cd Readme.skill
# Claude Code 用户
mkdir -p ~/.claude/skills/readme-skill
ln -sf "$(pwd)/skills/readme-skill/SKILL.md" ~/.claude/skills/readme-skill/SKILL.md
# Codex CLI 用户
mkdir -p ~/.codex/skills/readme-skill
ln -sf "$(pwd)/skills/readme-skill/SKILL.md" ~/.codex/skills/readme-skill/SKILL.md
# 方式二:直接复制
git clone https://github.com/study8677/Readme.skill.git
mkdir -p ~/.claude/skills/readme-skill
cp Readme.skill/skills/readme-skill/SKILL.md ~/.claude/skills/readme-skill/
# Codex 同理:mkdir -p ~/.codex/skills/readme-skill && cp ... ~/.codex/skills/readme-skill/
# 方式三:一行 curl
mkdir -p ~/.claude/skills/readme-skill && curl -fsSL https://raw.githubusercontent.com/study8677/Readme.skill/main/skills/readme-skill/SKILL.md -o ~/.claude/skills/readme-skill/SKILL.md
# Codex: 把 ~/.claude 替换为 ~/.codex
安装后在 Claude Code 或 Codex 的对话里说出以下任一句即可触发:
AI 会跑完整套流程,把结果写到 output/profile_<日期>.md + output/poster_<日期>_<lang>.svg,并在结束前校验 SVG 能被浏览器正常解析。除非你明确说「不要海报 / 只要 markdown」,否则默认会生成海报。如果指定月份 / 时间范围,文件名会带上窗口后缀,例如 output/profile_202605_<日期>.md 和 output/poster_202605_<日期>_<lang>.svg。中文提问出中文版,英文提问出英文版。
| 工具 | 状态 | 数据源 |
|---|---|---|
| Claude Code | ✅ 完整支持 | ~/.claude/stats-cache.json + history.jsonl + projects/*/*.jsonl + plans + skills + settings |
| Codex CLI | ✅ 完整支持 | ~/.codex/state_5.sqlite (read-only) + history.jsonl + skills + automations + rules |
| Kiro (AWS) | ✅ v2.5 新增 | ~/.kiro/sessions/cli/*.{json,jsonl} + ~/.local/share/kiro-cli/data.sqlite3 + ~/.kiro/{agents,skills,steering,prompts,settings} |
| Trae (ByteDance) | ⚠️ v2.5 部分支持 | ~/Library/Application Support/Trae/User/{workspaceStorage,globalStorage}/state.vscdb(chat 元数据,read-only)+ 项目 .trae/{rules,skills}。token 用量走云端 API,本 skill 不联网,默认缺失 |
| Gemini Antigravity (Google) | ✅ v2.5 新增(社区 PR #1 贡献) | ~/.gemini/antigravity/brain/<uuid>/:每个 task/session 的 *.metadata.json + task.md / implementation_plan.md / walkthrough.md。token 不可得,按 task/artifact 计数 + text-scale 估算(非计费) |
| Cursor (Anysphere) | ✅ v2.5.3 增强 | ~/Library/Application Support/Cursor/User/{workspaceStorage,globalStorage}/state.vscdb 的 composer.composerHeaders(标题 / subtitle / workspace / 时间 / 变更行数元数据)+ composer.* / aiService.* keys + 项目 .cursor/{rules,mcp.json} / .cursorrules。token 权威在云端 dashboard,本地不混算 |
| GitHub | ✅ 公开贡献 | gh api graphql —— 默认 365 天;指定时间范围时按窗口统计 contributions / top repos,语言和 stars 作为当前仓库属性展示 |
| 本地 Git | ✅ 完整支持 | 项目内只读 git log,默认过去一年;指定时间范围时按窗口统计 commit / +- 行数 |
用别的 AI IDE?欢迎提 Issue 告诉我数据路径,我会按同样模式接入。
两份产物:
10 个维度叙事,参考完整示例:examples/profile_20260515.md
1080×1920 竖屏,v2.4 链式传播版自带 3 件套:
& / < 等动态文本导致浏览器打开时报错# 方式 1: rsvg-convert (需要 brew install librsvg)
rsvg-convert -h 1920 output/poster_*.svg > poster.png
# 方式 2: 用 Chrome / 浏览器
open output/poster_*.svg # macOS 默认打开 → 右键另存为 PNG / 截图
# 方式 3: chromium headless
chromium --headless --screenshot=poster.png --window-size=1080,1920 output/poster_*.svg
| 项目 | 数据来源 | 输出 | 隐私 | 重点 |
|---|---|---|---|---|
| Readme.skill | 本地 Claude/Codex 对话 + GitHub + git log | 长报告 + 海报 | 全本地 / 默认脱敏 | AI 协作深度 |
| WakaTime | IDE 插件实时上报 | 网页 dashboard | 上传服务器 | 编程时长 |
| github-readme-stats | GitHub API | profile 卡片 | 公开数据 | 贡献量 |
| GitHub Skyline | GitHub 贡献日历 | 3D 模型 | 公开数据 | 视觉炫 |
简单说:别的工具看你"写了多少代码",Readme.skill 看你"怎么和 AI 一起写代码"。
gh 调用 GitHub 自身外不联网message.content)可被读取以增强关键词、协作风格、Session 架构分析,但原文不会写进报告~/.claude 或 ~/.codex 下任何文件(SQLite 用 mode=ro&immutable=1 打开)./output/,你随时可以 rm 或全文搜查2026-05、日期区间、最近 N 天,所有可过滤数据按统一窗口统计。--diff 跟上次生成的报告做快照对比;里程碑徽章(BILLION CLUB / 10K STARS)想看哪个先做?去 Issue 投票 或者 开 Discussion。
不会。整个 skill 是只读 + 本地:除了 gh 调用 GitHub 自身(你已经登录的账号),不发任何网络请求。SQLite 都用 mode=ro&immutable=1 打开,物理上不可写。
没问题。skill 内置降级策略:没有 ~/.codex/state_5.sqlite 就跳过 Codex 章节,只用 Claude 数据生成。报告照样能跑。
默认就是脱敏的。项目变「项目 A/B/C」,私有仓变 Private Repo X。如果你想要真名,加一句「私人版」。
理论上可以 —— SKILL.md 是 markdown 写的 AI 指令集,任何能调用文件读取和 shell 工具的 agent 都能跑。