akakika-skills
A small, carefully curated set of agent skills for building calm, native-feeling software — and for running AI coding agents well.
Apple/macOS design craft · SwiftUI · AI-agent workflows · project intelligence · upkeep · launch polish.
Browse the collection at akakika-skills.vercel.app — every skill, searchable, with copy-paste installs.
These are agent skills — plain SKILL.md files that teach an AI coding agent how to do one thing well. They work with Claude Code, Codex, Cursor, and anything else that reads the SKILL.md format. No build step, no dependencies — open one and read it.
This isn't a dump of everything I've made. It's only what I'd hand to someone — each skill stripped down, de-branded, and polished to the same bar. The through-line is taste: calm UI, native patterns, privacy by default, project upkeep that won't bite you, and agent workflows that don't fall apart on the second run.
The collection follows the life of a project — decide, design, build, run, maintain, launch, tell people, close the session well:
Project intelligence · Design · Apple HIG · Swift & macOS · AI agent workflows · Session rituals · Maintenance · Launch & review · Content & publishing
If you only grab three: new-project-gate before you build, apple-hig-command-palette while you design, macos-permissions-privacy when macOS says no.
Quickstart
Install everything on a Mac (recommended)
One-liner — clones (or updates) the repo under ~/Projects/akakika-skills and symlinks all 40 skills into every agent skill directory it knows about (Claude Code, Grok, Goose, Cursor, Codex, ~/.agents/skills):
curl -fsSL https://raw.githubusercontent.com/aka-kika/akakika-skills/main/install.sh | bash
From a clone:
git clone https://github.com/aka-kika/akakika-skills
cd akakika-skills
./install.sh
Useful flags:
./install.sh --dry-run # show what would happen
./install.sh --copy # copy instead of symlink
./install.sh --targets claude,grok # only some agents
./install.sh --dir ~/src/akakika-skills
Symlink installs track the clone: later updates are just git -C ~/Projects/akakika-skills pull (re-run ./install.sh only when new skill names appear). Existing skill folders with the same name are moved aside under ~/.skills-backup/ before linking.
Install one skill by hand
Every skill is a self-contained folder with a SKILL.md (Markdown + a little YAML). Drop the folder wherever your agent loads skills:
| Agent | Where it goes |
|---|
| Claude Code | Copy into ~/.claude/skills/ (global) or .claude/skills/ (per-project), then invoke it by name. |
| Codex | Copy into your project and reference it from AGENTS.md, or paste the SKILL.md body into context. |
| Cursor | Copy into .cursor/skills/ (or your rules folder) and reference it. |
| Anything else | Open the SKILL.md and paste the part you need. It's just Markdown. |
# grab one skill
git clone https://github.com/aka-kika/akakika-skills
cp -R akakika-skills/skills/apple-hig/apple-hig-command-palette ~/.claude/skills/
The skills
Project intelligence
Decide what deserves to exist, understand what already does, and keep agents from drifting.
| Skill | What it does |
|---|
| new-project-gate | A 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-time | Build-vs-buy verdict engine — should you build this, or does it already exist? Weighs effort, alternatives, and your time. |
| explain-new-project | Explains an unfamiliar codebase in plain language, written for non-technical and self-taught builders. |
| project-catch-up | A "what changed in my stack" research brief — dependency drift, breaking changes, and news, with severity labels. |
| project-workflow | Router that orchestrates explain / catch-up / worth-my-time with smart skip rules. |
| between-runs-audit | A read-only checkpoint between coding-agent runs — classifies everything KEEP / DELAY / REMOVE and ends with one unambiguous next action. |
| old-project-audit | KEEP / MERGE / ARCHIVE for tools that already exist — never limbo. Includes a non-negotiable footgun check for stale pipelines pointing at live data. |
Design
Tokens, color, and taste — the system the apps are built on.
| Skill | What it does |
|---|
| kika-design-system | A real, production design system — color/type/spacing tokens, components, and a SwiftUI reference implementation. Adopt it or adapt it. |
| color-principles | Seven principles for premium, calm, accessible color — a review lens for any UI, website, or app. |
Apple HIG
Native Apple design, to spec — the patterns that make an app feel like it belongs.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
