{"id":50084243,"url":"https://github.com/basicScandal/claude-skins","last_synced_at":"2026-06-08T09:01:19.657Z","repository":{"id":356250939,"uuid":"1216901885","full_name":"basicScandal/claude-skins","owner":"basicScandal","description":"Custom skins (visual themes) for Claude Code CLI","archived":false,"fork":false,"pushed_at":"2026-05-07T08:48:01.000Z","size":2517,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T09:37:28.889Z","etag":null,"topics":["ascii-art","claude","claude-code","cli","skins","terminal","terminal-themes","themes"],"latest_commit_sha":null,"homepage":"https://basicscandal.github.io/claude-skins/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/basicScandal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T10:49:08.000Z","updated_at":"2026-05-07T08:48:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/basicScandal/claude-skins","commit_stats":null,"previous_names":["basicscandal/claude-skins"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/basicScandal/claude-skins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicScandal%2Fclaude-skins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicScandal%2Fclaude-skins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicScandal%2Fclaude-skins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicScandal%2Fclaude-skins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basicScandal","download_url":"https://codeload.github.com/basicScandal/claude-skins/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basicScandal%2Fclaude-skins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34055249,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ascii-art","claude","claude-code","cli","skins","terminal","terminal-themes","themes"],"created_at":"2026-05-22T18:00:36.858Z","updated_at":"2026-06-08T09:01:19.630Z","avatar_url":"https://github.com/basicScandal.png","language":"Shell","funding_links":[],"categories":["Ecosystem"],"sub_categories":["GateGuard — Fact-Forcing PreToolUse Gate"],"readme":"# Claude Skins\n\nCustom skins (visual themes) for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI.\n\n![Claude Skins Demo](https://basicscandal.github.io/claude-skins/demo.gif)\n\nSkins transform the full Claude Code experience — terminal colors, ASCII art banners, themed status lines, Claude's voice/personality, and tool feedback sounds. They don't affect core behavior — just how things look, sound, and feel.\n\nInspired by [hermes-skins](https://github.com/joeynyc/hermes-skins). Mythos and Netrunner banner art adapted from that project under MIT license.\n\n**[View the gallery](https://basicscandal.github.io/claude-skins/)**\n\n## Quick Start\n\n1. Clone this repo:\n\n```bash\ngit clone https://github.com/basicScandal/claude-skins.git\n```\n\n2. Run the installer:\n\n```bash\ncd claude-skins\n./install.sh\n```\n\n3. Activate a skin:\n\n```bash\n# In Claude Code, use the /skin command\n/skin nebula\n\n# Or set a permanent default\n/skin default\n```\n\nThat's it. Missing values inherit from the default skin, so you only need to define what you want to change.\n\n## Manual Installation\n\nIf you prefer to set things up yourself:\n\n1. Copy `skins/` and `personalities/` to `~/.claude/skins/`\n2. Copy `engine/` to `~/.claude/skins/engine/`\n3. Make engine scripts executable: `chmod +x ~/.claude/skins/engine/*.sh`\n4. Add hooks to your `~/.claude/settings.json` (see [Hooks Setup](#hooks-setup))\n5. Create the `/skin` skill (see [Skill Setup](#skill-setup))\n\n## Available Skins\n\n### Nebula\nOffensive security scanner — purple-to-orange gradient, tactical precision.\n\n→ [nebula.yaml](skins/nebula.yaml)\n\n![nebula](https://basicscandal.github.io/claude-skins/nebula.gif)\n\n### Mythos\nAGI awakening — Greek mythology meets artificial intelligence. Eye of Providence braille art, blue and gold divine palette.\n\n→ [mythos.yaml](skins/mythos.yaml)\n\n![mythos](https://basicscandal.github.io/claude-skins/mythos.gif)\n\n### Netrunner\nCyberpunk netrunner — neural interface hacker aesthetic. Cyan ICE-breaking colors on black, skull braille art.\n\n→ [netrunner.yaml](skins/netrunner.yaml)\n\n![netrunner](https://basicscandal.github.io/claude-skins/netrunner.gif)\n\n### Noir\n1940s detective procedural — high-contrast black and cream, amber accents, hardboiled Chandler narration.\n\n→ [noir.yaml](skins/noir.yaml)\n\n![noir](https://basicscandal.github.io/claude-skins/noir.gif)\n\n### Sensei\nMinimalist Japanese ink-wash aesthetic — warm parchment, deep charcoal, vermillion hanko seal accent.\n\n→ [sensei.yaml](skins/sensei.yaml)\n\n![sensei](https://basicscandal.github.io/claude-skins/sensei.gif)\n\n### Mission Control\nNASA retro-futurist ops console — amber phosphor on deep navy, Apollo-era mission control aesthetic.\n\n→ [mission-control.yaml](skins/mission-control.yaml)\n\n![mission-control](https://basicscandal.github.io/claude-skins/mission-control.gif)\n\n### Retro86\n1980s Commodore 64 nostalgia — classic C64 blue palette, 8-bit ASCII art, enthusiastic magazine voice.\n\n→ [retro86.yaml](skins/retro86.yaml)\n\n![retro86](https://basicscandal.github.io/claude-skins/retro86.gif)\n\n### Brutalist\nThe anti-skin — pure monochrome, zero decoration, no sounds, maximum terseness.\n\n→ [brutalist.yaml](skins/brutalist.yaml)\n\n![brutalist](https://basicscandal.github.io/claude-skins/brutalist.gif)\n\n### Grimoire\nDark academia spellbook — deep brown parchment, golden arcane sigils, patient wizard's codex voice.\n\n→ [grimoire.yaml](skins/grimoire.yaml)\n\n![grimoire](https://basicscandal.github.io/claude-skins/grimoire.gif)\n\n## What a Skin Changes\n\n| Layer | What it does |\n|-------|-------------|\n| **Terminal colors** | Background, foreground, cursor, and ANSI palette via OSC sequences |\n| **ASCII banner** | Braille art + block letter logo displayed on session start |\n| **Status line** | Themed colors, icon, and progress bar in the Claude Code status bar |\n| **Personality** | Output style that shapes Claude's voice (oracular, hacker, tactical) |\n| **Tool sounds** | macOS system sounds triggered on file writes, commands, errors |\n\n## Commands\n\n```\n/skin              List available skins, highlight active one\n/skin \u003cname\u003e       Switch to a skin immediately\n/skin reset        Deactivate skin, restore terminal defaults\n/skin default      Set current skin as permanent default\n```\n\nSwitching is instant — no restart needed.\n\n## Hooks Setup\n\nAdd these to your `~/.claude/settings.json` under `\"hooks\"`:\n\n**SessionStart** — activate default skin on boot:\n```json\n{\n  \"type\": \"command\",\n  \"command\": \"~/.claude/skins/engine/activate.sh\"\n}\n```\n\n**SessionEnd** — restore terminal on exit:\n```json\n{\n  \"type\": \"command\",\n  \"command\": \"~/.claude/skins/engine/deactivate.sh\"\n}\n```\n\n**PostToolUse** — themed sounds (optional):\n```json\n{\n  \"matcher\": \"Bash|Write|Edit|MultiEdit|Grep|Glob\",\n  \"hooks\": [{\n    \"type\": \"command\",\n    \"command\": \"~/.claude/skins/engine/skin-tool-hook.sh\",\n    \"timeout\": 5\n  }]\n}\n```\n\n**Status line** — replace your current statusline:\n```json\n\"statusLine\": {\n  \"type\": \"command\",\n  \"command\": \"~/.claude/skins/engine/statusline.sh\"\n}\n```\n\n## Skill Setup\n\nCreate `~/.claude/skills/skin/SKILL.md` — see [engine/SKILL.md](engine/SKILL.md) for the content.\n\n## Creating Your Own Skin\n\n1. Copy [template.yaml](template.yaml) to `skins/\u003cname\u003e.yaml`\n2. Customize colors, banner art, branding\n3. Optionally add `personalities/\u003cname\u003e.md` for Claude's voice\n4. Test: `~/.claude/skins/engine/activate.sh \u003cname\u003e`\n\nSee [SCHEMA.md](SCHEMA.md) for the full reference and [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Requirements\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI\n- Terminal with OSC sequence support (iTerm2, Kitty, WezTerm, Ghostty, Alacritty, Windows Terminal, Terminal.app)\n- Tool sounds work on macOS, Linux (PulseAudio/ALSA), and WSL — see [COMPATIBILITY.md](COMPATIBILITY.md)\n\n## Using a Skin? Let Us Know\n\nIf you're using claude-skins, we'd love to hear about it! Open a [Discussion](https://github.com/basicScandal/claude-skins/discussions) or tag the repo in your dotfiles.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nBanner art for Mythos and Netrunner adapted from [joeynyc/hermes-skins](https://github.com/joeynyc/hermes-skins) under MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FbasicScandal%2Fclaude-skins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FbasicScandal%2Fclaude-skins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FbasicScandal%2Fclaude-skins/lists"}