Skip to content
Skills Library
Personal productivity · Automation

folderstyle

/folderstyle

Set a Finder tint (tag color) and an SF Symbol or emoji on macOS Tahoe folders. Use when creating or reorganizing folders on a Mac and the user wants them color-coded and labeled with symbols.

Repository
folderstyle ↗
Licence
MIT
Last repository change
10.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set a Finder tint (tag color) and an SF Symbol or emoji on macOS Tahoe folders. Use when creating or reorganizing folders on a Mac and the user wants them color-coded and labeled with symbols.

Original author description

Set a Finder tint (tag color) and an SF Symbol or emoji on macOS Tahoe folders. Use when creating or reorganizing folders on a Mac and the user wants them color-coded and labeled with symbols.

How it works

  1. Usage
  2. How it works
  3. Rules learned in testing
  4. Verified symbols (rendered in Finder on macOS 26)
  5. Color scheme
  6. Workflow
Original SKILL.md headings · 67 lines, 509 words
SKILL.md preview
---
name: folderstyle
description: Set a Finder tint (tag color) and an SF Symbol or emoji on macOS Tahoe folders. Use when creating or reorganizing folders on a Mac and the user wants them color-coded and labeled with symbols.
---

# FolderStyle - MacOS Folder Styles for Claude

Applies the macOS 26 (Tahoe) folder look: a tint from a Finder tag color plus a symbol or emoji drawn on the folder icon. Style every new folder you create. Restyle existing folders only when asked.

## Usage

```
python3 -I scripts/folderstyle.py <folder> <Color|-> <sym:NAME|emoji:CHAR|->
```

Examples:

```
python3 -I scripts/folderstyle.py ~/Documents/Taxes Orange sym:banknote.fill
python3 -I scripts/folderstyle.py ~/Documents/Trips - emoji:✈️
python3 -I scripts/folderstyle.py ~/Documents/Archive Gray -
```

Colors: Gray, Green, Purple, Blue, Yellow, Red, Orange. Use `-` to skip the color or the glyph. The script prints the attributes it wrote.

The script runs natively on macOS and from a Linux shell that has a Mac folder mounted (for example a desktop-app bridge). Pass paths as arguments and run Python with `-I`.

## How it works

- Tint and label: a Finder tag color in `com.apple.metadata:_kMDItemUserTags`, written as a binary plist of strings like `Orange\n7`.
- Symbol: `com.apple.icon.folder#S` holding `{"sym":"house.fill"}` or `{"emoji":"🏠"}`.
- `com.apple.FinderInfo` gets the custom-icon flag (byte 8, 0x04) so a symbol-only folder renders.
- All three are undocumented. Verify after writing and report failures plainly.

## Rules learned in testing

1. Never put a `.` in the name of a folder you style. Names like `v2.0` or `notes.fill` look like a document type to Finder and the symbol silently does not render. Use dashes. If a dotted folder exists, offer to rename it with `mv`; the attributes travel with it.
2. Dots inside the symbol name are fine (`house.fill`).
3. A symbol name that is not in the system catalog fails silently with a plain folder. Ask the user to check any new name in Finder before relying on it.
4. Many symbols outside Finder's Customize Folder picker work, including recent ones.
5. Skip system folders (Applications, Library, System, Users) and anything outside folders the user gave you.
6. Existing non-color tags are kept. An existing standard color tag is replaced.
7. Requires macOS 26 or later. Say so and skip on older systems.

## Verified symbols (rendered in Finder on macOS 26)

house.fill, banknote.fill, building.columns.fill, person.2.fill, airplane, antenna.radiowaves.left.and.right, camera.fill, cross.case.fill, star.fill, atom, hurricane, scissors, stethoscope, tortoise.fill, cup.and.saucer.fill, teddybear.fill, bolt.horizontal.fill, dice.fill, sailboat.fill, puzzlepiece.extension.fill, applescript.fill, externaldrive.connected.to.line.below.fill, textformat.characters.arrow.left.and.right, dollarsign.gauge.chart.leftthird.topthird.rightthird. Emoji also work.

Known to fail: names that are not in the catalog.

## Color scheme

Ask the user for their scheme, or edit this default:

| Color | Meaning |
|---|---|
| Blue | Work |
| Green | Home and property |
| Purple | Business or side projects |
| Orange | Finance, legal, tax |
| Red | Urgent, needs action |
| Yellow | In progress, drafts |
| Gray | Archive, reference |

## Workflow

1. Create folders with dot-free names, then style them in the same step.
2. Report what you applied in a short table (folder, color, symbol).
3. If a symbol does not show, check the folder name for dots first, then try an emoji.
4. Mention any symbol not on the verified list so the user can confirm it in Finder.
Files in this package (3)
  • LICENSE 1 KB
  • README.md 3 KB
  • SKILL.md 4 KB

Versions

The database has no other skills named folderstyle.

Database snapshot: 13.11.2026 · package version 3fefdb0965b6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100ops-mac
    OPS on-demand: This skill should be used when the user asks to \"mac is slow\", \"macos fix\", or…
  • 100macos-tahoe-apis
    Guide to macOS 26 Tahoe APIs and features. Covers Apple Intelligence (FoundationModels), MLX framework, and Continuity. Use when implementing macOS 26 specific features.
  • 100ui-review-tahoe
    Comprehensive UI/UX review for macOS Tahoe apps. Covers Liquid Glass design, HIG compliance, SwiftUI patterns, and accessibility. Use when reviewing macOS UI or checking HIG compliance.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.