Agent skills
Teach your coding agent one thing well.
akakika-skills is a curated collection of 40 agent skills — plain SKILL.md files that teach AI coding agents how to do one thing well. They cover Apple Human Interface Guidelines, SwiftUI and macOS implementation, project intelligence, session rituals, maintenance, launch polish, and calm publishing.
- Skills
- 40
- Categories
- 9
- Format
- SKILL.md
- License
- MIT
The collection
Forty skills. Nine chapters.
40 of 40
01Project intelligence
Decide what deserves to exist, understand what already does, keep agents from drifting.
- new-project-gatestart hereA pre-build gate that kills bad ideas cheaply — six checkpoints, an agent lens and a human lens, and a GO / CUT / KILL verdict before the editor opens.
- project-worth-my-timeBuild-versus-buy verdict engine — should you build this, or does it already exist? Weighs effort, alternatives, and your time.
- explain-new-projectExplains an unfamiliar codebase in plain language, written for non-technical and self-taught builders.
- project-catch-upA what-changed-in-my-stack research brief — dependency drift, breaking changes, and news, with severity labels.
- project-workflowRouter that orchestrates explain, catch-up, and worth-my-time with smart skip rules.
- between-runs-auditA read-only checkpoint between coding-agent runs — classifies everything KEEP / DELAY / REMOVE and ends with one next action.
- old-project-auditKEEP / MERGE / ARCHIVE for tools that already exist — never limbo. Includes a footgun check for stale pipelines pointing at live data.
02Design
Tokens, color, and taste — the system the apps are built on.
03Apple HIG
Native Apple design, to spec — the patterns that make an app feel like it belongs.
- apple-hig-command-palettestart hereA full ⌘K command palette: scoring and ranking, an action registry, and accessibility.
- apple-hig-sidebarsNavigationSplitView sidebars — two- versus three-column, grouping, and keeping navigation calm.
- apple-hig-toolbarsToolbars — per-screen action maps, one clear primary action, and placement discipline.
- apple-hig-inspectorsInspector panels done right — when to use one, the item model, and per-type detail views.
- apple-hig-macos-window-layoutThe macOS window shell — sizing, and when to use a sheet versus a window versus a popover.
- apple-hig-typographyThe text-style scale — sizes, weights, monospaced digits, and line-length caps for legible Apple typography.
- apple-hig-sf-symbolsChoosing and using SF Symbols — a nav, action, and status vocabulary, variants, and rendering modes.
- apple-hig-search-filteringSearch, filter, and sort — a clean separation of the three, with a working filter function.
- apple-hig-empty-statesEmpty, first-run, and no-result states — six typed cases built on ContentUnavailableView.
- apple-hig-feedback-statusFeedback, status, progress, and alerts — a real state vocabulary and no fake percentages.
- apple-hig-settingsSettings and Preferences — scenes, AppStorage versus Keychain, and SMAppService.
04Swift & macOS
Implementation from MenuBarExtra to notarization — the plumbing that has to be exact.
- macos-menubar-swiftuiMenu-bar apps with MenuBarExtra plus an AppKit bridge — the accurate, compilable reference.
- apple-app-intentsApp Intents, Shortcuts, Siri, and Spotlight, with full Swift — intents, entities, enums — and tests.
- macos-launch-at-loginLaunch at Login with SMAppService — all four statuses handled, an honest Settings toggle, and migration off deprecated APIs.
- macos-global-shortcutsIn-app versus global shortcuts — KeyboardShortcuts or raw RegisterEventHotKey, recorder UI, conflicts, and safe defaults.
- macos-notificationsUNUserNotificationCenter done right — permission at the moment of need, action buttons, click routing, and anti-spam rules.
- macos-permissions-privacystart hereThe TCC permission map — which API, plist key, and entitlement each permission needs, plus denied-state recovery and honest privacy copy.
- macos-clipboard-pasteboardNSPasteboard — rich writes with fallbacks, changeCount polling, concealed and transient conventions, and Sequoia paste privacy.
- macos-app-distribution-dmgShip outside the App Store — Developer ID, hardened runtime, notarytool, stapling, a clean DMG, and the quarantine test your Mac cannot run on itself.
05AI agent workflows
Run coding agents well — state, local models, and projects agents can actually drive.
- agent-state-machineOne shared state machine for agent, task, and run states — legal transitions and a recovery path out of every failure.
- local-ai-ollamaWire local models (Ollama) into an app or agent — client protocol, status, and fallback rules.
- agent-starter-packScaffold an agent-ready project — an AGENTS.md and an idempotent bootstrap script.
06Session rituals
How a working session starts, forks, and ends — options before work, causality after.
- spreadBefore improving anything, a menu of 3–5 concrete interventions on the exact input, lightest to heaviest — then wait for the pick.
- butterfly-effectA counterfactual session trace — walk backward from the outcome and keep only the 2–4 load-bearing moments. Causality, not summary.
- tilTeach exactly one thing from the session, in plain English, two paragraphs max. Closes the vocabulary gap for builders who ship without a CS background.
07Maintenance
Keep a project healthy after the excitement wears off.
08Launch & review
The last mile — polish, review, and ship with a clear head.
09Content & publishing
Tell people, calmly — posts and pages without the hype.
Install
One command. Forty skills. Every agent it knows about.
The installer clones the repo and symlinks each skill into Claude Code, Cursor, Codex, Grok, Goose, and ~/.agents/skills. Later updates are a git pull.
curl -fsSL https://raw.githubusercontent.com/aka-kika/akakika-skills/main/install.sh | bash01
Run the installer
Paste the command in Terminal. Use --dry-run first if you want to see the plan.
02
Agents pick them up
Each skill folder lands where the agent already looks. Invoke by name, or let the “Use when…” line decide.
03
Update in place
Symlinks track the clone. git pull brings edits; re-run install.sh only when new skill names appear.
How skills work
A folder. A “Use when…”. The craft underneath.
Each skill is a self-contained folder with a SKILL.md. Agents read the frontmatter to decide relevance, then pull the body on demand. You can also just open the file — it is Markdown, not a plugin.
---
name: apple-hig-sidebars
description: Use when designing, reviewing,
or implementing a sidebar for an
Apple-platform app.
---
# Apple HIG Sidebars
…the craft.Specific, not generic
Real expertise over promptable advice. A sharp trigger so the agent knows when to reach for it — and when not to.
Complete, not a sketch
Rules, code, and checklists in one file. Enough to do the job without a second conversation to fill the gaps.
Taste as the through-line
Calm UI, native patterns, privacy by default, and agent workflows that do not fall apart on the second run.
FAQ