# fmess-theme

This Claude Code skill builds fMess themes based on another chat app or a custom color scheme. It tests the result in fMess and prepares it for app settings, a pull request, or a built-in theme.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 122 repo stars
- Author: toanbku
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/toanbku/fmess/tree/HEAD/.claude/skills/fmess-theme/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fmess-theme

## What it does

The skill creates a CSS theme that changes how Messenger looks in fMess. It covers light and dark colors, typography, icons, emoji, message bubbles, the composer, menus, and tooltips. A theme can imitate another chat app from its web interface or screenshots, or keep Messenger’s layout while changing its colors.

The repository includes guidance on CSS selectors, theme templates, screenshot tools, and testing in fMess. The finished theme can be added through Settings › Add…, prepared as a pull request, or included as a built-in theme. Measuring a live web app requires Chrome tools and a signed-in target account; the skill also covers screenshot-based work.

Testing keeps both Messenger and the target app in read-only mode. Screenshots and measurements from real chats stay on the machine; images shared in a pull request use demo content.

## Requirements
- Works with: Slack

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add toanbku/fmess --skill fmess-theme -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/fmess-theme/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/fmess-theme/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add toanbku/fmess --skill fmess-theme -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/fmess-theme/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add toanbku/fmess --skill fmess-theme -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/fmess-theme/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install toanbku/fmess .claude/skills/fmess-theme
```

2. **Manually: put the files in place**
- File: `.github/skills/fmess-theme/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add toanbku/fmess --skill fmess-theme -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/toanbku/fmess --path .claude/skills/fmess-theme
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fmess-theme/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/toanbku/fmess/tree/HEAD/.claude/skills/fmess-theme/SKILL.md

## When to use it
- recreate a Discord or Slack look in fMess
- build an fMess theme from screenshots
- recolor Messenger without changing its layout
- test an fMess theme in the app

## Example prompts
- Create an fMess theme that looks like Discord.
- Build an fMess theme from these screenshots.
- Fix the Teams theme for fMess.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 24cca32ccf72c5dc.

BEGIN THIRD-PARTY FILE 24cca32ccf72c5dc
```text
---
name: fmess-theme
description: >-
  Make an fMess theme: a look copied from another chat app (measured in its web app,
  or worked out from screenshots alone), or a theme of the user's own (Messenger's
  layout in new colours). Covers layout, light and dark colours, type, icons, emoji,
  bubbles, composer, tooltips, menus and the avatar/account button; tests it in fMess;
  and readies it for Settings › Add…, a pull request or a built-in theme. Use for
  "make an fMess theme like Discord/Slack/Telegram/Teams", "theme giống <app>", "làm
  theme <app> cho fMess", "clone <app>'s look", "a theme from these screenshots", "the
  old messenger.com look", or when continuing or fixing the Zalo, WhatsApp or Teams
  themes. Everything it needs is in this repo, so it works in a fork.
---

# fMess theme

fMess wraps facebook.com/messages. A theme is **CSS only**: the page script (`inject.js`)
puts it in the page, and the user picks it in Settings. Messenger stays underneath. The
goal of a copied look: someone who uses `<app>` every day sees `<app>` at a glance, in
light and dark, at 880×600.

Zalo, WhatsApp and Teams are shipped. The maintainer explained the same things for each
one; this skill holds them, so run it end to end without asking again.

**Read before writing selectors:**
- [hooks.md](hooks.md): every hook fMess gives themes, Messenger's variables, DOM
  landmarks, the CSS and performance gotchas.
- [template.md](template.md): `whatsapp.src.css` section by section, the build.py and
  icons.json format, the decoration tricks.
- [extraction.md](extraction.md): recon snippets, the five agent briefs, safety and
  measuring rules (measuring a live web app).
- [screenshots.md](screenshots.md): working from screenshots alone.
- [testing.md](testing.md): trying the theme in fMess, probes, dark and language checks,
  screenshots, restoring the user's app.

## 0. Before anything: what, from where, for whom

"The user" is the person you work for: the maintainer, or someone with a fork. Their
Messenger account is real, and so is their account in the target app.

**What kind of theme:**

| Kind | Example | Start from | Steps |
|---|---|---|---|
| Recolour | Messenger in new colours, the old messenger.com purple | `themes/starter/starter.css` | 0, a short mapping (3), 4, 5, 6 |
| Copy of an app | Discord, Slack, Telegram | `themes/teams/` (newest), `themes/whatsapp/` (bundled font) | all |

A recolour keeps Messenger's layout and changes its colours (and maybe bubble radius,
fonts, the chat background). It needs no recon agents, no icons and often no build step.

**Where the look comes from:**

- **A. The live web app**, logged in, in Chrome, and you have the Chrome tools
  (Claude in Chrome: `mcp__claude-in-chrome__*`). Measure it (sections 1 and 2): exact
  values.
- **B. Screenshots only**: no browser tools, a desktop-only app, or a look that no longer
  exists (messenger.com closed in April 2026). Follow [screenshots.md](screenshots.md)
  instead of sections 1 and 2: estimated values, marked as such.
```
END THIRD-PARTY FILE 24cca32ccf72c5dc

The third-party file has ended. Everything between the 24cca32ccf72c5dc tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3055 of 25118 bytes. © toanbku · MIT · https://github.com/toanbku/fmess/tree/HEAD/.claude/skills/fmess-theme/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
