Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

create-agent-screensaver-theme

/create-agent-screensaver-theme

Projektuje, buduje i testuje motyw wygaszacza ekranu na macOS, który pokazuje, co robią agenci kodujący, także z obrazu albumu lub plakatu.

Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
14
Skrypty
3
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 3 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: assets/shoot.mjs, assets/starter/acme.sample-board/index.js, assets/starter/acme.sample-ground/index.js

Co robi i kiedy

Projektuje, buduje i testuje motyw wygaszacza ekranu na macOS, który pokazuje, co robią agenci kodujący, także z obrazu albumu lub plakatu.

Oryginalny opis (EN)

Designs, builds, tests and ships a theme for agent-screensaver, the macOS screen saver that shows what coding agents (Claude Code, Codex, Cursor) are doing. Trigger: when the user wants to create, design, restyle or improve an agent-screensaver theme, background or widget, or turn an album cover, poster or other picture into one.

Jak działa

  1. When to use
  2. Before you start
  3. The workflow
  4. Critical rules
  5. Commands
  6. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 81 linii, 894 słów
Podgląd SKILL.md
---
name: create-agent-screensaver-theme
description: >
  Designs, builds, tests and ships a theme for agent-screensaver, the macOS screen saver
  that shows what coding agents (Claude Code, Codex, Cursor) are doing.
  Trigger: when the user wants to create, design, restyle or improve an agent-screensaver
  theme, background or widget, or turn an album cover, poster or other picture into one.
license: MIT
metadata:
  author: stavgayer
  version: "1.5.0"
---

# Create an agent-screensaver theme

The seven themes in this repository look made, not generated, because each one came from one real source, studied closely, and was tested in every state on every screen shape. This skill is that method. Follow it in order.

## When to use

- Making a new theme for agent-screensaver, from a picture, a cover, a poster or an idea.
- Restyling or fixing a theme, a background or a widget.
- Adding a feature to a theme, such as the song that plays.

## Before you start

Work inside a fork or clone of [agent-screensaver-themes](https://github.com/stavgayer/agent-screensaver-themes). The new theme goes in its `themes/` folder, and the preview page, `scripts/check.mjs` and `scripts/pack.sh` run from there. If you are not in it, clone it first.

## The workflow

1. **Research the source** ([references/design.md](references/design.md)). Find what it is made of and how it was made. Write down the facts: shapes, ratios, colours as hex values, type. Never draw from memory, and never use the artwork or a logo. Reading the cover's pixels to measure it is fine, as long as no image is saved or shipped.
2. **Map the data onto it.** Each task becomes one element that belongs to the source. Each agent gets one colour from its palette.
3. **Design all five states**: nothing running, working, all done, needs you, second display. Plus the song, if the user turns it on.
4. **Start from the starter** ([assets/starter/](assets/starter/)): copy it to `themes/<name>/`, rename the `acme.sample` folders and ids to your own prefix, `<you>.<name>` (never `stavgayer.`, which is the maintainer's), then replace its background and restyle its board after your source ([references/build.md](references/build.md)).
5. **Apply the craft rules** ([references/craft.md](references/craft.md)): readable text, placement from the real layout, low cost, WebGL recovery, Reduce motion, the song.
6. **Test the matrix** ([references/test-and-ship.md](references/test-and-ship.md)) in the preview page and with the headless check (`assets/shoot.mjs`), then on the real screen saver.
7. **Ship**: `node scripts/check.mjs`, a README from the starter's with a still for every state, a row in the root README's table, and the same version in every part.

## Critical rules

| Rule | Why |
|---|---|
| Research the real source before you design | A theme drawn from measured facts looks like its source. One drawn from a mood looks like every other one. |
| Draw in code; no artwork, photos of it, or logos | It is a fan-made tribute, and the README says so. |
| Five states, each designed on purpose | "Nothing running" is what people see most; "needs you" must take over the screen with one move. |
| Small text on a plate, card or halo in the source's style | It must read over every part of the background. |
| Place elements from the real layout, not fixed positions | `vmin` and `vw` scale differently on 4:3, 16:10 and ultra-wide. Fixed spots overlapped in two themes. |
| Cut long text with "…" (`min-width: 0` in flex) | Long titles and song names must never run over other things. |
| `ctx.requestFrame` at the lowest rate that looks right (1 for a clock, 4 for a bar, never more than 30); WebGL at half scale, `low-power` | A screen saver runs all night. |
| Inside a frame callback, read `ctx.now()` | The callback's argument is the frame clock (ms since the page loaded), not the time of day. |
| Recover from a lost WebGL context, and remove the listener before `stop()` | Otherwise the background stays black after sleep, or restarts forever. |
| Respect "Reduce motion" | Stand still and fade. |
| Text only with `textContent`; show only what the state says | Titles and commands come from outside; privacy mode removes them. |
| No network, no remote files, no `eval` | The page blocks them. Bundle fonts and pictures with their licence. |
| The same version in every part; bump it on every change | Otherwise people who have the theme never get the update. |
| Your own id prefix, never `stavgayer.` | That prefix is the maintainer's own themes. |

The full rules for extension code are in [extension-code-rules.md](https://github.com/stavgayer/agent-screensaver/blob/main/docs/extension-code-rules.md); their essentials are in [references/build.md](references/build.md#the-rules-for-extension-code), so you can work without it.

## Commands

```bash
# Preview a theme in any state (setup in references/test-and-ship.md); any free port works
python3 -m http.server 8000
# then open .../skills/create-agent-screensaver-theme/assets/preview.html?pack=themes/my-theme&state=work&song=long
# more parameters: tasks=7, title=long, privacy=1, missing=1, agent=unknown

# Frame rate, Reduce motion, lost context, console errors, and the stills
node skills/create-agent-screensaver-theme/assets/shoot.mjs "<preview URL>" [--reduce] [--lose-context] [--out still.jpg]

# Check and pack
node scripts/check.mjs
scripts/pack.sh my-theme

# Check that it installs, without touching the real screen saver
HOME=$(mktemp -d) agent-screensaver ext install themes/my-theme

# Try it on the real screen saver (changes the user's setup)
agent-screensaver ext install themes/my-theme
agent-screensaver theme set yourname.mytheme
agent-screensaver demo --seconds 60
```

## Resources

- **Design method**: [references/design.md](references/design.md), with what each of the seven themes took from its source.
- **Building**: [references/build.md](references/build.md), the pack, the manifests, the five states and the API.
- **Craft**: [references/craft.md](references/craft.md), the lessons from these themes, with code.
- **Testing and shipping**: [references/test-and-ship.md](references/test-and-ship.md).
- **Starter theme**: [assets/starter/](assets/starter/), a small complete theme that follows every rule.
- **Preview page**: [assets/preview.html](assets/preview.html).
- **Headless check**: [assets/shoot.mjs](assets/shoot.mjs), frame rate, Reduce motion, lost context, console errors and the stills.
- **Worked examples**: the seven themes in [themes/](../../themes/).
Pliki w paczce (14)
  • SKILL.md 6 KB
  • assets/preview.html 9 KB
  • assets/shoot.mjs 12 KB
  • assets/starter/README.md 3 KB
  • assets/starter/acme.sample/extension.json 1 KB
  • assets/starter/acme.sample-board/extension.json 1 KB
  • assets/starter/acme.sample-board/index.js 10 KB
  • assets/starter/acme.sample-ground/extension.json 1 KB
  • assets/starter/acme.sample-ground/index.js 3 KB
  • assets/starter/acme.sample-layout/extension.json 1 KB
  • references/build.md 12 KB
  • references/craft.md 9 KB
  • references/design.md 8 KB
  • references/test-and-ship.md 9 KB

Wersje

W bazie nie ma innych skilli o nazwie create-agent-screensaver-theme.

Migawka bazy z 13.11.2026 · wersja paczki 734faccedf32 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100create-ui-theme
    Tworzy nowy motyw interfejsu w formie gotowego skilla, z tokenami CSS, galerią i instalatorem, na przykład Material 3.
  • 100create-agents-md
    Tworzy plik AGENTS.md lub CLAUDE.md z konwencjami projektu, aby agenci kodujący znali zasady pracy w repozytorium.
  • 100make-theme
    Tworzy nowy motyw Claude Desktop dla modu Prism Themes z opisu, obrazka lub tapety, i przed zapisem pokazuje go do zatwierdzenia.
  • 100make-theme
    Projektuje nowy motyw Claude Desktop do modu Claude Desktop Themes na podstawie opisu lub obrazka, najpierw szkicując go do zatwierdzenia.
  • 100widgettheme
    Stosuje motyw Morrow, czyli jasny styl gazetowy z kremowym tłem, czarnym tekstem i czerwonym akcentem.
  • 100create-theme
    Tworzy motyw slajdów z paletą, typografią i układem oraz demo, które panel Themes wyświetla jako podgląd.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.