An open API service indexing awesome lists of open source software.

https://github.com/dadwadw233/vibeportrait

๐ŸŽญ Know yourself as a developer. One command โ†’ AI analyzes your coding history โ†’ beautiful personality portrait + persona skill. Works with Claude Code & Codex.
https://github.com/dadwadw233/vibeportrait

agent-skill ai-tools claude-code codex developer-tools mbti personality vibe-coding

Last synced: 2 months ago
JSON representation

๐ŸŽญ Know yourself as a developer. One command โ†’ AI analyzes your coding history โ†’ beautiful personality portrait + persona skill. Works with Claude Code & Codex.

Awesome Lists containing this project

README

          

VibePortrait Banner


[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude_Code-skill-14b8a6?logo=anthropic&logoColor=white)](https://claude.ai/claude-code)
[![Codex](https://img.shields.io/badge/Codex-skill-10a37f?logo=openai&logoColor=white)](https://github.com/openai/codex)
[![GitHub stars](https://img.shields.io/github/stars/dadwadw233/VibePortrait?style=social)](https://github.com/dadwadw233/VibePortrait)
[![Release](https://img.shields.io/github/v/release/dadwadw233/VibePortrait?color=14b8a6)](https://github.com/dadwadw233/VibePortrait/releases)

**Your AI conversations already know who you are. VibePortrait makes it visible.**

[English](#what-is-vibeportrait) ยท [ไธญๆ–‡](#vibeportrait-ๆ˜ฏไป€ไนˆ)

---

### โšก 30-Second Demo

```bash
# Install (one time)
cp -R VibePortrait/skills/vibe-portrait ~/.claude/skills/vibe-portrait

# Run
/vibe-portrait
```

**Input:** Your `~/.claude/history.jsonl` + `~/.codex/history.jsonl` (read-only, never sent anywhere)

**Output:**

| Output | What you get |
|--------|-------------|
| ๐Ÿ“„ `vibe-portrait.html` | Beautiful portrait page โ€” open in browser, export as PNG |
| ๐Ÿง  `~/.claude/skills/.../me/` | Persona skill โ€” say "think like me" in any future conversation |
| ๐Ÿ”„ `my-vibe-portrait` repo | Private GitHub repo syncing portraits across all your machines |

๐Ÿ“ธ What the portrait looks like (click to expand)


VibePortrait Preview

*The portrait includes: MBTI type with per-type color theme ยท 6-axis capability radar ยท developer rating (ๅคฏ็ˆ†ไบ†โ†’ๆ‹‰ๅฎŒไบ†) ยท 3-dimension famous match ยท communication style analysis ยท tech domain map ยท work rhythm heatmap ยท and more.*

---

## What is VibePortrait?

A skill for **Claude Code** and **Codex**. It reads your conversation history and generates:

- **๐Ÿ–ผ๏ธ HTML Portrait** โ€” MBTI type (16 color themes), radar chart, developer rating, 3D famous match, communication style, tech domain map, work rhythm heatmap
- **๐Ÿง  Persona Skill** โ€” multi-file skill capturing your thinking patterns, decision framework, engineering philosophy โ€” loadable by any AI ("think like me")
- **๐Ÿ“ธ Image Export** โ€” one-click PNG for sharing on social media
- **๐Ÿ”„ Multi-machine Sync** โ€” private GitHub repo keeps everything in sync across all your dev machines

> Rating philosophy: judged by **observable output**, not claims or intent. No flattery. Evidence speaks.

---

## VibePortrait ๆ˜ฏไป€ไนˆ๏ผŸ

ไธ€ไธช **Claude Code / Codex ๆŠ€่ƒฝ**๏ผŒ่ฏปๅ–ไฝ ็š„ๅฏน่ฏๅކๅฒ๏ผŒ็”Ÿๆˆ๏ผš

- **๐Ÿ–ผ๏ธ HTML ็”ปๅƒ้กต** โ€” ๅ•ๆ–‡ไปถ็ฝ‘้กต๏ผŒๅซ MBTIใ€่ƒฝๅŠ›้›ท่พพใ€ๅผ€ๅ‘่€…่ฏ„็บงใ€ๅไบบๅŒน้…็ญ‰ๅฏ่ง†ๅŒ–
- **๐Ÿง  ไบบๆ ผ Skill** โ€” ๅ‡็ปƒไฝ ็š„ๆ€็ปดๆ–นๅผ๏ผŒ่ฎฉ AI ่ƒฝ"ๅƒไฝ ไธ€ๆ ทๆ€่€ƒ"
- **๐Ÿ“ธ ไธ€้”ฎๅฏผๅ‡บๅ›พ็‰‡** โ€” PNG ๆ ผๅผ๏ผŒๆ–นไพฟๅˆ†ไบซ
- **๐Ÿ”„ ๅคšๆœบๅ™จๅŒๆญฅ** โ€” ้€š่ฟ‡ private GitHub ไป“ๅบ“่ทจๆœบๅ™จๅŒๆญฅ

> ่ฏ„ๅˆ†ๅ“ฒๅญฆ๏ผšไปฅ**ๅฏ่ง‚ๅฏŸ็š„ๅฎž้™…ไบงๅ‡บ**ไธบๅ‡†ใ€‚ไธ่ฐ„ๅชš๏ผŒไธๆŽจๆต‹ใ€‚่ฏๆฎ่ฏด่ฏใ€‚

---

## Quick Start / ๅฟซ้€Ÿๅผ€ๅง‹

**Claude Code (marketplace):**

```bash
# Step 1: Add marketplace
/plugin marketplace add dadwadw233/VibePortrait

# Step 2: Install
/plugin install vibe-portrait@vibe-portrait

# Step 3: Run
/vibe-portrait:vibe-portrait
```

**Claude Code (manual):**

```bash
git clone https://github.com/dadwadw233/VibePortrait.git
cp -R VibePortrait/skills/vibe-portrait ~/.claude/skills/vibe-portrait
/vibe-portrait
```

**Codex:**

```bash
$skill-installer install https://github.com/dadwadw233/VibePortrait/tree/main/skills/vibe-portrait
# Then: Use $vibe-portrait to generate my developer personality portrait.
```

---

## How It Works / ๅทฅไฝœๆต็จ‹

```
โšก Quick mode (~200 msgs) or ๐Ÿ” Full mode (all msgs)
โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Read conversation history โ”‚
โ”‚ + import from other machinesโ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Analyze 6 dimensions โ”‚
โ”‚ โ†’ MBTI ยท Rating ยท Famous โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Generate outputs โ”‚
โ”‚ ๐Ÿ“„ HTML ๐Ÿง  Skill ๐Ÿ“ธ PNG โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Sync to GitHub (optional) โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```

---

## Portrait Contents / ็”ปๅƒๅ†…ๅฎน

| | Section | Description |
|-|---------|-------------|
| ๐Ÿงฌ | **MBTI Type** | 4-axis mapping with per-type color theme / ๅ››่ฝดๆ˜ ๅฐ„ + 16 ็ง็‹ฌ็ซ‹้…่‰ฒ |
| ๐Ÿ“Š | **Radar** | Depth ยท Breadth ยท Communication ยท Decision ยท Collaboration ยท Creativity |
| ๐Ÿ† | **Rating** | `Legendary ๅคฏ็ˆ†ไบ†` โ†’ `Elite ๅคฏ` โ†’ `Above Avg ไบบไธŠไบบ` โ†’ `NPC` โ†’ `Below Avg ๆ‹‰` โ†’ `Inactive ๆ‹‰ๅฎŒไบ†` |
| ๐ŸŽญ | **Famous Match** | 3 dimensions: Technical Spirit ยท Strategic Mind ยท Communication Soul โ€” AI picks from all of human history |
| ๐Ÿ’ฌ | **Communication** | Language split, directness, keywords / ่ฏญ่จ€ๅˆ†ๅธƒใ€็›ดๆŽฅๅบฆใ€ๅ…ณ้”ฎ่ฏ |
| ๐Ÿ—บ๏ธ | **Tech Map** | Domain breakdown + tool badges / ้ข†ๅŸŸๅˆ†ๅธƒ + ๅทฅๅ…ทๅพฝ็ซ  |
| โฐ | **Work Rhythm** | 24h heatmap + session patterns / 24h ็ƒญๅŠ›ๅ›พ + ไผš่ฏๆจกๅผ |

## MBTI Themes / ้…่‰ฒไธป้ข˜

| Group | Types | Colors |
|-------|-------|--------|
| ๐Ÿง  Analysts ๅˆ†ๆžๅธˆ | INTJ ยท INTP ยท ENTJ ยท ENTP | Teal + Slate ้’็ปฟ็ฐ่“ |
| ๐Ÿ’š Diplomats ๅค–ไบคๅฎ˜ | INFJ ยท INFP ยท ENFJ ยท ENFP | Emerald + Amber ็ฟ ็ปฟ็ฅ็€ |
| ๐Ÿ›ก๏ธ Sentinels ๅ“จๅ…ต | ISTJ ยท ISFJ ยท ESTJ ยท ESFJ | Cobalt + Steel ้’ด่“้’ข็ฐ |
| ๐Ÿ”ฅ Explorers ๆŽข้™ฉๅฎถ | ISTP ยท ISFP ยท ESTP ยท ESFP | Gold + Rose ้‡‘ๆฉ™็Žซ็บข |

---

## Persona Skills / ไบบๆ ผๆŠ€่ƒฝ

VibePortrait generates a skill that captures: thinking patterns, decision framework, communication style, engineering philosophy.

**No raw chat messages are included** โ€” only abstracted mindset markers.

```bash
# Activate personas / ๆฟ€ๆดปไบบๆ ผ
think like me # Your own / ไฝ ่‡ชๅทฑ็š„
ๅƒ้ฉฌๆ–ฏๅ…‹ไธ€ๆ ทๆ€่€ƒ่ฟ™ไธช้—ฎ้ข˜ # Community / ็คพๅŒบไบบๆ ผ
think like linus-torvalds # By ID

# Manage / ็ฎก็†
update my portrait # Incremental update (only new msgs) / ๅขž้‡ๆ›ดๆ–ฐ
install persona from # Install from GitHub / ๅฎ‰่ฃ…
list personas # See installed / ๆŸฅ็œ‹ๅทฒๅฎ‰่ฃ…
remove persona # Uninstall / ๅˆ ้™ค
```

```
~/.claude/skills/vibe-portrait-personas/
โ”œโ”€โ”€ me/ โ† yours (auto-generated, multi-file)
โ”‚ โ”œโ”€โ”€ SKILL.md
โ”‚ โ”œโ”€โ”€ portrait-meta.json โ† timestamps for incremental updates
โ”‚ โ””โ”€โ”€ references/
โ”‚ โ”œโ”€โ”€ thinking-patterns.md
โ”‚ โ”œโ”€โ”€ decision-framework.md
โ”‚ โ”œโ”€โ”€ communication-style.md
โ”‚ โ”œโ”€โ”€ engineering-philosophy.md
โ”‚ โ””โ”€โ”€ mindset-markers.md
โ”œโ”€โ”€ elon-musk/ โ† installed from GitHub
โ”‚ โ””โ”€โ”€ ...
โ””โ”€โ”€ zhuge-liang/ โ† installed from community
โ””โ”€โ”€ ...
```

---

## Multi-Machine Sync / ๅคšๆœบๅ™จๅŒๆญฅ

Syncs via **private GitHub repo** using `gh` CLI.

```
Machine A โ”€โ”€pushโ”€โ”€โ–บ my-vibe-portrait (private) โ—„โ”€โ”€pushโ”€โ”€ Machine B
โ”œโ”€โ”€ me/SKILL.md
โ”œโ”€โ”€ analysis/macbook.json
โ”œโ”€โ”€ analysis/linux-4090.json
โ”œโ”€โ”€ portraits/latest.html
โ””โ”€โ”€ README.md (auto-filled)
```

First run creates the repo. Subsequent runs on any machine pull โ†’ merge โ†’ push.

---

## Privacy / ้š็ง

- Only reads local `~/.claude/history.jsonl` โ€” never sends data externally
- API keys, tokens, passwords, file paths, personal info auto-redacted from all outputs
- Persona skills contain **zero raw chat messages** โ€” only abstracted personality descriptions
- Portrait repo is private by default โ€” you control what to share

> ๐Ÿ›ก๏ธ **Want real-time protection?** Try [**VibeGuard**](https://github.com/dadwadw233/VibeGuard) โ€” a security plugin for Claude Code that detects secrets, blocks dangerous commands, and logs all tool actions. Pairs naturally with VibePortrait: VibeGuard protects your code in real-time, VibePortrait ensures your exported persona stays clean.
>
> ```bash
> npm install -g @embodot/vibeguard && vibeguard install
> ```

---

## Requirements / ็Žฏๅขƒ่ฆๆฑ‚

- Claude Code or Codex with 20+ messages of history
- Modern browser for HTML viewing
- `gh` CLI for multi-machine sync (optional)

---

## Roadmap

- [x] HTML portrait with 10 visual sections + MBTI color themes
- [x] Persona skill generation (abstracted, no raw quotes)
- [x] Bilingual (zh/en) + one-click image export
- [x] Multi-machine sync via private GitHub repo
- [x] Materialist rating rubric
- [ ] Community platform for sharing & discovering persona skills

---

**Every great developer evolves. The first step is seeing clearly where you stand.**

**ๆฏไธ€ๆฌกๅฏน่ฏ้ƒฝๆ˜ฏไฝ ็š„่ฟ›ๅŒ–่ฝจ่ฟนใ€‚็œ‹่ง่‡ชๅทฑ๏ผŒๅˆ†ไบซ่‡ชๅทฑ๏ผŒๆˆไธบๆ›ดๅผบ็š„่‡ชๅทฑใ€‚**