Foundations

Agent skill

The Puppertino skill teaches an AI agent to design for the web the way Apple’s Human Interface Guidelines ask, and to write Puppertino markup instead of inventing class names. It ships in the Puppertino repository, in the skills/puppertino folder, as a standard SKILL.md with two reference files.

It works with Claude Code, Codex, Cursor and any tool that reads the Agent Skills format.

Install

With the skills installer:

npx skills add codedgar/Puppertino

In Claude Code, as a plugin:

claude plugin marketplace add codedgar/Puppertino
claude plugin install puppertino@puppertino

By hand, copy the folder into your skills directory:

git clone --depth 1 https://github.com/codedgar/Puppertino
cp -r Puppertino/skills/puppertino ~/.claude/skills/puppertino

What it knows

What it keeps out of your interface

The Apple logo, Apple trademarks as your product’s name, SF Pro font files, Apple’s own icons, artwork and screenshots, and any claim that the result is made or endorsed by Apple. The skill describes what it builds as following Apple’s Human Interface Guidelines.

Puppertino is tuned for products that use Apple’s components. Ask for a full desktop or a Finder in a browser tab and the agent builds it, with one note that the framework is not tuned for that shape.

Example prompt

Build the account settings page for a Mac companion app. Sidebar on the left with General, Notifications and Privacy. The General pane has name, email, a sync switch and a List or Grid segmented control. One Save button.

The agent picks the desktop set, loads one stylesheet, writes the sidebar, the form and the buttons from the recipes, uses --p- tokens for every color, and checks dark mode and focus before it answers.

How it is kept current

The skill lives next to the framework, so a component change and its recipe change in the same commit. The version in SKILL.md matches the npm release.

Copied