Readme.skill
A skill that builds an anonymized developer profile and a vertical poster from local Claude Code and other CLI history
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Reads local tool history and runs SQLite queries
- Calls gh for public GitHub contributions
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/readme-skillDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .claude/skills
cp -R "$tmp/skills/readme-skill" .claude/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .github/skills
cp -R "$tmp/skills/readme-skill" .github/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .devin/skills
cp -R "$tmp/skills/readme-skill" .devin/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .cline/skills
cp -R "$tmp/skills/readme-skill" .cline/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .roo/skills
cp -R "$tmp/skills/readme-skill" .roo/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add study8677/readme.skill --skill readme-skill -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 21cdd16
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/study8677/readme.skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/readme-skill/
git -C "$tmp" checkout 21cdd16ca9a209715d595ee57205f733b09590a0
mkdir -p .agents/skills
cp -R "$tmp/skills/readme-skill" .agents/skills/readme-skillCommands for macOS and Linux, on Windows run them in Git Bash.
Install the skill: /plugin marketplace add study8677/Readme.skill, then /plugin install readme-skill@study8677. Say: generate my AI-work profile.
Other ways from the author
/plugin marketplace add study8677/Readme.skill
/plugin install readme-skill@study8677GitHub contribution data needs gh installed.
This is third-party code. Review the repository files before installing.
What it does
The skill reads local usage data from several tools: Claude Code, Codex CLI, Kiro, Trae, Gemini Antigravity and Cursor, computes a set of metrics and produces two outputs: a long markdown report and a vertical SVG poster. The report covers AI-work practices across ten dimensions, and you can set a window: a month, a date range or the last few days. By default everything is anonymized: project names become placeholders, private repos are hidden, and keys, tokens and email are scrubbed. It all runs locally; the only network call is a request for your public GitHub contributions via gh.
Who it is for. For developers who want to show their AI-work experience as a clear profile and poster.
Good fit when
- You want a profile for the top of your GitHub page
- You want a monthly or quarterly review of your AI-tool work
- You want a poster with key numbers for social media
Not a fit when
- You have no local history from any supported tool
- You cannot run a local analysis of your work data
Example request
Generate my AI-work developer profile for the last thirty daysLimitations
The skill counts only the tools whose history is on the machine and skips the missing ones. The interface and references are mostly Chinese, with English output on request. GitHub contribution data needs gh installed; the rest runs locally without writing into the agent's directory.
How to disable. Uninstall the readme-skill plugin via /plugin or remove the skill folder from the agent's skills directory.
Security check
- Reads local tool history and runs SQLite queries
- Calls gh for public GitHub contributions
README in short
The README describes a skill that quickly turns real AI-tool usage data into an anonymized developer card: a long report and a vertical poster. Six tools are supported and any missing one is skipped automatically. Work is fully local and read-only, without writing into the agent's directory, with anonymization on by default and secret scrubbing via regular expressions. It offers monthly and windowed reports and Chinese or English output. Installation is a few steps and it ships as a plugin with marketplace.json. MIT licensed.
SKILL.md
--- name: readme-skill description: > 生成一份对外可分享、脱敏的 AI-Native 开发者 README。 量化展示我对 Claude Code + Codex CLI + Kiro (AWS) + Trae (ByteDance) + Gemini Antigravity (Google) + Cursor 的使用深度、AI 协作风格、 项目与领域分布、兴趣主题，以及与 GitHub 提交的产出关联。 Trigger when the user says: "生成我的 AI 档案" / "做一份 AI-native README" / "分析我的 Claude / Codex / Kiro / Trae / Antigravity / Cursor 使用情况" / "build my AI usage profile" / "build my monthly AI coding report". 全程本地、只读、默认匿名、不上传任何数据。 license: MIT --- # Readme.skill — AI-Native 开发者档案生成器 You (the AI agent invoking this skill) will read local Claude Code + Codex CLI + Kiro (AWS) + Trae (ByteDance) + Gemini Antigravity (Google) + Cursor data, compute a fixed set of dimensions, and render both a Markdown profile and a validated SVG poster under `./output/` in the user's requested language. **You do all of the work** — read the files with `Read`, query sqlite via `Bash`, synthesize the prose yourself, then write and validate the SVG. ## Step 1 — 准备 ```bash cd <repo-with-this-skill> mkdir -p output DATE=$(date +%Y%m%d) ```
FAQ
Is any data sent anywhere?
No, the analysis is local and read-only; the only outbound call is for public GitHub contributions via gh.
Can project names be hidden?
By default they are already anonymized, private repos and secrets are scrubbed, and the non-anonymized mode is enabled explicitly.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI