@olegkoval/agent-skills 1.12.0 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/.claude-plugin/plugin.json +6 -2
  2. package/.cursor-plugin/index.json +15 -0
  3. package/.kiro/steering/apple-store-submit.md +145 -0
  4. package/.kiro/steering/cloudflare-block-countries.md +0 -1
  5. package/.kiro/steering/docs-index-keeper.md +0 -1
  6. package/.kiro/steering/fill-music-player.md +0 -1
  7. package/.kiro/steering/gallery.md +0 -1
  8. package/.kiro/steering/gh-cli.md +0 -1
  9. package/.kiro/steering/git-commit.md +0 -1
  10. package/.kiro/steering/macos-menubar-app.md +225 -0
  11. package/.kiro/steering/mvp-oneshot.md +164 -0
  12. package/.kiro/steering/obsidian-pr-sync.md +0 -1
  13. package/.kiro/steering/obsidian-task-rollover.md +0 -1
  14. package/.kiro/steering/open-source-publisher.md +0 -1
  15. package/.kiro/steering/product-builder.md +0 -1
  16. package/.kiro/steering/promptctl.md +0 -1
  17. package/.kiro/steering/review-past-performance.md +0 -1
  18. package/.kiro/steering/search-console-indexing-audit.md +0 -1
  19. package/.kiro/steering/semantic-release-beta.md +0 -1
  20. package/.kiro/steering/starter-rules.md +0 -1
  21. package/.kiro/steering/viral-launch.md +0 -1
  22. package/.windsurf/rules/apple-store-submit.md +144 -0
  23. package/.windsurf/rules/cloudflare-block-countries.md +0 -1
  24. package/.windsurf/rules/docs-index-keeper.md +0 -1
  25. package/.windsurf/rules/fill-music-player.md +0 -1
  26. package/.windsurf/rules/gallery.md +0 -1
  27. package/.windsurf/rules/gh-cli.md +0 -1
  28. package/.windsurf/rules/git-commit.md +0 -1
  29. package/.windsurf/rules/macos-menubar-app.md +224 -0
  30. package/.windsurf/rules/mvp-oneshot.md +163 -0
  31. package/.windsurf/rules/obsidian-pr-sync.md +0 -1
  32. package/.windsurf/rules/obsidian-task-rollover.md +0 -1
  33. package/.windsurf/rules/open-source-publisher.md +0 -1
  34. package/.windsurf/rules/product-builder.md +0 -1
  35. package/.windsurf/rules/promptctl.md +0 -1
  36. package/.windsurf/rules/review-past-performance.md +0 -1
  37. package/.windsurf/rules/search-console-indexing-audit.md +0 -1
  38. package/.windsurf/rules/semantic-release-beta.md +0 -1
  39. package/.windsurf/rules/starter-rules.md +0 -1
  40. package/.windsurf/rules/viral-launch.md +0 -1
  41. package/catalog/skills.json +90 -0
  42. package/collections/product-tools.json +1 -1
  43. package/collections/prompt-tools.json +1 -1
  44. package/collections/software-development.json +2 -1
  45. package/package.json +1 -1
  46. package/packages/software-development/apple-store-submit/SKILL.md +157 -0
  47. package/packages/software-development/apple-store-submit/adapters/claude/plugin.json +5 -0
  48. package/packages/software-development/apple-store-submit/adapters/claude/skills/apple-store-submit/SKILL.md +158 -0
  49. package/packages/software-development/apple-store-submit/adapters/codex/README.md +3 -0
  50. package/packages/software-development/apple-store-submit/adapters/cursor/plugin.json +6 -0
  51. package/packages/software-development/apple-store-submit/adapters/cursor/skills/apple-store-submit/SKILL.md +158 -0
  52. package/packages/software-development/apple-store-submit/adapters/kiro/steering/apple-store-submit.md +145 -0
  53. package/packages/software-development/apple-store-submit/adapters/windsurf/rules/apple-store-submit.md +144 -0
  54. package/packages/software-development/macos-menubar-app/SKILL.md +237 -0
  55. package/packages/software-development/macos-menubar-app/adapters/claude/plugin.json +5 -0
  56. package/packages/software-development/macos-menubar-app/adapters/claude/skills/macos-menubar-app/SKILL.md +238 -0
  57. package/packages/software-development/macos-menubar-app/adapters/codex/README.md +3 -0
  58. package/packages/software-development/macos-menubar-app/adapters/cursor/plugin.json +6 -0
  59. package/packages/software-development/macos-menubar-app/adapters/cursor/skills/macos-menubar-app/SKILL.md +238 -0
  60. package/packages/software-development/macos-menubar-app/adapters/kiro/steering/macos-menubar-app.md +225 -0
  61. package/packages/software-development/macos-menubar-app/adapters/windsurf/rules/macos-menubar-app.md +224 -0
  62. package/packages/software-development/mvp-oneshot/LICENSE +21 -0
  63. package/packages/software-development/mvp-oneshot/SKILL.md +175 -0
  64. package/packages/software-development/mvp-oneshot/adapters/claude/plugin.json +5 -0
  65. package/packages/software-development/mvp-oneshot/adapters/claude/skills/mvp-oneshot/SKILL.md +176 -0
  66. package/packages/software-development/mvp-oneshot/adapters/codex/README.md +3 -0
  67. package/packages/software-development/mvp-oneshot/adapters/cursor/plugin.json +6 -0
  68. package/packages/software-development/mvp-oneshot/adapters/cursor/skills/mvp-oneshot/SKILL.md +176 -0
  69. package/packages/software-development/mvp-oneshot/adapters/kiro/steering/mvp-oneshot.md +164 -0
  70. package/packages/software-development/mvp-oneshot/adapters/windsurf/rules/mvp-oneshot.md +163 -0
  71. package/packages/software-development/skill-budget-audit/SKILL.md +145 -0
  72. package/packages/software-development/skill-budget-audit/adapters/claude/plugin.json +5 -0
  73. package/packages/software-development/skill-budget-audit/adapters/claude/skills/skill-budget-audit/SKILL.md +146 -0
  74. package/scripts/build-adapters.sh +11 -9
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "olko-agent-skills",
3
3
  "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools.",
4
- "version": "1.11.1",
4
+ "version": "1.13.0",
5
5
  "author": {
6
6
  "name": "Oleg Koval"
7
7
  },
@@ -17,6 +17,7 @@
17
17
  "./packages/software-development/promptctl",
18
18
  "./packages/music/fill-music-player",
19
19
  "./packages/software-development/product-builder",
20
+ "./packages/software-development/mvp-oneshot",
20
21
  "./packages/software-development/starter-rules",
21
22
  "./packages/software-development/review-past-performance",
22
23
  "./packages/software-development/open-source-publisher",
@@ -24,6 +25,9 @@
24
25
  "./packages/marketing/search-console-indexing-audit",
25
26
  "./packages/software-development/cloudflare-block-countries",
26
27
  "./packages/software-development/obsidian-pr-sync",
27
- "./packages/software-development/obsidian-task-rollover"
28
+ "./packages/software-development/obsidian-task-rollover",
29
+ "./packages/software-development/apple-store-submit",
30
+ "./packages/software-development/macos-menubar-app",
31
+ "./packages/software-development/skill-budget-audit"
28
32
  ]
29
33
  }
@@ -41,6 +41,11 @@
41
41
  "source": "./packages/software-development/product-builder/adapters/cursor",
42
42
  "description": "Build a full-stack web application or SaaS product from a user description using production-oriented defaults."
43
43
  },
44
+ {
45
+ "name": "olko:mvp-oneshot",
46
+ "source": "./packages/software-development/mvp-oneshot/adapters/cursor",
47
+ "description": "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice."
48
+ },
44
49
  {
45
50
  "name": "olko:starter-rules",
46
51
  "source": "./packages/software-development/starter-rules/adapters/cursor",
@@ -80,6 +85,16 @@
80
85
  "name": "olko:obsidian-task-rollover",
81
86
  "source": "./packages/software-development/obsidian-task-rollover/adapters/cursor",
82
87
  "description": "Bullet-journal end-of-day task migration: copy unchecked tasks from today's Obsidian daily note to the next workday's note under '## Carried over', and mark them [>] in the source. Skips weekends, idempotent."
88
+ },
89
+ {
90
+ "name": "olko:apple-store-submit",
91
+ "source": "./packages/software-development/apple-store-submit/adapters/cursor",
92
+ "description": "Handle Apple App Store rejection emails end-to-end: parse rejection reasons, plan fixes, implement code changes, navigate App Store Connect, and resubmit."
93
+ },
94
+ {
95
+ "name": "olko:macos-menubar-app",
96
+ "source": "./packages/software-development/macos-menubar-app/adapters/cursor",
97
+ "description": "Build a production-quality macOS menubar or notch app in SwiftUI — MenuBarExtra, sandbox entitlements, keyboard shortcuts, sound effects, accessibility permissions, and App Store preparation."
83
98
  }
84
99
  ]
85
100
  }
@@ -0,0 +1,145 @@
1
+ <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
2
+
3
+ ---
4
+ inclusion: manual
5
+ description: "Handle Apple App Store rejection emails end-to-end: parse rejection reasons, plan fixes, implement code changes, navigate App Store Connect, and resubmit."
6
+ ---
7
+
8
+ > 🤖 *Auto-generated by **weekly-pattern-learner** · App Store rejection handling workflow observed in FocusNotch App Store session, Jun 2026 (92 user turns covering rejection → plan → code fixes → metadata → resubmit)*
9
+
10
+ # Apple App Store Submission & Rejection Handling
11
+
12
+ ## Overview
13
+
14
+ Parse Apple rejection feedback, implement targeted fixes, update App Store Connect metadata, and resubmit — covering the complete cycle from rejection email to approved build.
15
+
16
+ ## When to Use
17
+
18
+ - Apple review team sends a rejection email
19
+ - App fails automated pre-review checks (binary rejected at upload)
20
+ - Preparing metadata for first-time submission (screenshots, keywords, privacy labels)
21
+ - Resolving App Store Connect errors before submitting for review
22
+
23
+ ## Workflow
24
+
25
+ ### 1. Parse the Rejection
26
+
27
+ Read the full rejection email. Extract and list:
28
+
29
+ - **Guideline numbers** violated (e.g., 2.1, 4.2.0, 5.1.1)
30
+ - **Code-level issues** — missing entitlements, incorrect privacy strings, sandbox violations
31
+ - **Metadata issues** — wrong screenshot sizes, subtitle policy, keyword stuffing
32
+ - **UX issues** — crashes described by reviewer, broken flows, missing functionality
33
+
34
+ Create a numbered fix plan: one item per rejection point, with the type of fix needed.
35
+
36
+ ### 2. Classify Fixes by Type
37
+
38
+ | Type | Location |
39
+ |------|----------|
40
+ | Privacy usage strings missing | `Info.plist` |
41
+ | Entitlement missing/wrong | `<AppName>.entitlements` |
42
+ | Crash or broken feature | Source code |
43
+ | Screenshots wrong size/content | App Store Connect |
44
+ | Keywords/subtitle/description | App Store Connect |
45
+ | Build number conflict | Xcode + App Store Connect |
46
+
47
+ ### 3. Implement Code Fixes
48
+
49
+ **Privacy permission strings** (`Info.plist`):
50
+
51
+ ```xml
52
+ <key>NSMicrophoneUsageDescription</key>
53
+ <string>Used for voice input during focus sessions.</string>
54
+
55
+ <key>NSCalendarsUsageDescription</key>
56
+ <string>Used to sync tasks with your calendar.</string>
57
+ ```
58
+
59
+ **Entitlements** (`<AppName>.entitlements`):
60
+
61
+ ```xml
62
+ <key>com.apple.security.app-sandbox</key>
63
+ <true/>
64
+ <key>com.apple.security.network.client</key>
65
+ <true/>
66
+ <key>com.apple.security.files.user-selected.read-write</key>
67
+ <true/>
68
+ ```
69
+
70
+ **Sandbox violations** — remove `NoEscapeBlock` patterns, replace deprecated APIs, use only sandboxed file access via Security-Scoped Bookmarks when needed.
71
+
72
+ ### 4. Build and Archive
73
+
74
+ ```bash
75
+ # Clean build
76
+ xcodebuild clean \
77
+ -scheme <AppName> \
78
+ -destination 'generic/platform=macOS'
79
+
80
+ # Archive
81
+ xcodebuild archive \
82
+ -scheme <AppName> \
83
+ -archivePath build/<AppName>.xcarchive \
84
+ -destination 'generic/platform=macOS'
85
+
86
+ # Export for App Store
87
+ xcodebuild -exportArchive \
88
+ -archivePath build/<AppName>.xcarchive \
89
+ -exportPath build/export \
90
+ -exportOptionsPlist ExportOptions.plist
91
+ ```
92
+
93
+ Validate codesigning before upload:
94
+
95
+ ```bash
96
+ codesign --verify --deep --strict --verbose=4 build/export/<AppName>.app
97
+ spctl --assess --verbose=4 build/export/<AppName>.app
98
+ ```
99
+
100
+ ### 5. Update App Store Connect Metadata
101
+
102
+ Navigate: **My Apps → [App] → App Store tab**
103
+
104
+ Common metadata fixes:
105
+
106
+ - **App name**: max 30 chars
107
+ - **Subtitle**: max 30 chars, no duplicate keywords from the title field
108
+ - **Keywords**: 100-char total limit, comma-separated, no spaces after commas
109
+ - **Screenshots**: exact pixel dimensions per device type (check Apple's current spec)
110
+ - **Privacy Nutrition Labels**: must accurately reflect data collected/linked to user
111
+ - **Build selection**: select the newly uploaded build before submitting
112
+
113
+ ### 6. Write Reviewer Notes
114
+
115
+ In the submission form, fill **Notes for Reviewer**:
116
+
117
+ - Explain each rejection point and what was changed
118
+ - Reference specific guideline numbers: "Addressing 2.1 — added NSMicrophoneUsageDescription to Info.plist"
119
+ - If a feature requires special credentials to test, provide test account details
120
+
121
+ ### 7. Submit and Track
122
+
123
+ 1. Upload via **Xcode Organizer → Distribute App → App Store Connect**
124
+ 2. In App Store Connect: select the new build, fill notes, **Submit for Review**
125
+ 3. Typical re-review: 24–48h
126
+ 4. If rejected again: respond in the **Resolution Center** thread (same case number)
127
+ 5. Escalate via Resolution Center for policy disagreements — do not open a new submission
128
+
129
+ ## Build Number Protocol
130
+
131
+ Apple rejects builds with a duplicate build number. Increment `CFBundleVersion` in `Info.plist` or Xcode target settings before every upload:
132
+
133
+ ```bash
134
+ # Bump build number (e.g., 9 → 10)
135
+ xcrun agvtool new-version -all 10
136
+ ```
137
+
138
+ ## Verification
139
+
140
+ - [ ] Every rejection guideline number has a corresponding fix in the plan
141
+ - [ ] `xcodebuild archive` exits 0 with no warnings about entitlements
142
+ - [ ] `codesign --verify` passes
143
+ - [ ] App Store Connect shows build status as "Ready to Submit"
144
+ - [ ] Reviewer Notes reference each changed item
145
+ - [ ] Build number is higher than any previously uploaded build
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Block specific countries via Cloudflare WAF Custom Rules using the Cloudflare API. Handles creating new rulesets and updating existing ones across single or multiple zones."
6
6
  ---
7
7
 
8
-
9
8
  # Cloudflare Country Block via WAF Custom Rules
10
9
 
11
10
  Block traffic from specific countries using Cloudflare WAF Custom Rules and the Cloudflare API.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Keep a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows."
6
6
  ---
7
7
 
8
-
9
8
  # docs-index-keeper
10
9
 
11
10
  Use this skill when a repository keeps docs under `docs/` and needs a Markdown index table updated automatically as docs are added or changed.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Fill a portable music player with a curated random selection from a source music library while balancing formats, artists, albums, and capacity."
6
6
  ---
7
7
 
8
-
9
8
  # fill-music-player
10
9
 
11
10
  Curates a DJ-balanced selection of tracks from a source music library and copies them to a portable player, respecting device capacity and supported formats.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Create photo galleries with AI-assisted layout curation and sequencing."
6
6
  ---
7
7
 
8
-
9
8
  # Gallery Workflow
10
9
 
11
10
  Composed skill that creates photo galleries by orchestrating atomic scripts and sub-agents.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Use the GitHub CLI effectively for repositories, PRs, Actions, releases, and more."
6
6
  ---
7
7
 
8
-
9
8
  # GitHub CLI (gh)
10
9
 
11
10
  Comprehensive reference for GitHub CLI (gh) - work seamlessly with GitHub from the command line.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Create conventional commits with diff-aware staging and message generation."
6
6
  ---
7
7
 
8
-
9
8
  # Git Commit with Conventional Commits
10
9
 
11
10
  ## Overview
@@ -0,0 +1,225 @@
1
+ <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
2
+
3
+ ---
4
+ inclusion: manual
5
+ description: "Build a production-quality macOS menubar or notch app in SwiftUI — MenuBarExtra, sandbox entitlements, keyboard shortcuts, sound effects, accessibility permissions, and App Store preparation."
6
+ ---
7
+
8
+ > 🤖 *Auto-generated by **weekly-pattern-learner** · SwiftUI macOS menubar app pattern observed in FocusNotch session, Jun 2026 (364 user turns, ~48 MB transcript covering idea → spec → impl → critique cycles → App Store)*
9
+
10
+ # macOS Menubar / Notch App (SwiftUI)
11
+
12
+ ## Overview
13
+
14
+ Build a macOS app that lives in the menu bar or notch using SwiftUI's `MenuBarExtra`. Covers the full lifecycle: project setup, window management, entitlements, user interaction (keyboard shortcuts, sound), and App Store preparation.
15
+
16
+ ## When to Use
17
+
18
+ - User asks to build an app for the macOS menubar, status bar, or notch
19
+ - Adding a menubar presence to an existing macOS app
20
+ - Debugging sandbox rejections or entitlement errors in a SwiftUI app
21
+
22
+ ## Workflow
23
+
24
+ ### 1. Project Setup
25
+
26
+ Create a new macOS App target in Xcode:
27
+
28
+ - **Interface**: SwiftUI
29
+ - **App Sandbox**: Enabled (required for App Store)
30
+ - **Bundle ID**: `com.yourname.AppName`
31
+ - **Deployment target**: macOS 13+ (for `MenuBarExtra`)
32
+
33
+ In `Info.plist`, set:
34
+
35
+ ```xml
36
+ <key>LSUIElement</key>
37
+ <true/>
38
+ ```
39
+
40
+ This hides the app from the Dock — the menu bar becomes the only entry point.
41
+
42
+ ### 2. MenuBarExtra (SwiftUI native)
43
+
44
+ ```swift
45
+ @main
46
+ struct FocusApp: App {
47
+ var body: some Scene {
48
+ MenuBarExtra {
49
+ ContentView()
50
+ .frame(width: 320, height: 480)
51
+ } label: {
52
+ Label("Focus", systemImage: "timer")
53
+ }
54
+ .menuBarExtraStyle(.window)
55
+ }
56
+ }
57
+ ```
58
+
59
+ Use `.menuBarExtraStyle(.window)` for a popover-style panel. Use `.menuBarExtraStyle(.menu)` for a dropdown menu.
60
+
61
+ ### 3. Notch Detection
62
+
63
+ On MacBooks with a notch, the safe area changes. Detect and adapt:
64
+
65
+ ```swift
66
+ func isNotchPresent() -> Bool {
67
+ guard let screen = NSScreen.main else { return false }
68
+ // The notch area is excluded from visibleFrame top
69
+ let screenHeight = screen.frame.height
70
+ let visibleTop = screen.visibleFrame.maxY
71
+ return visibleTop < screenHeight
72
+ }
73
+ ```
74
+
75
+ Position windows below the notch:
76
+
77
+ ```swift
78
+ window.setFrameOrigin(NSPoint(
79
+ x: window.frame.origin.x,
80
+ y: NSScreen.main!.frame.height - window.frame.height - notchOffset
81
+ ))
82
+ ```
83
+
84
+ ### 4. Sandbox Entitlements
85
+
86
+ Minimum `.entitlements` for a sandboxed menubar app:
87
+
88
+ ```xml
89
+ <?xml version="1.0" encoding="UTF-8"?>
90
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
91
+ <plist version="1.0">
92
+ <dict>
93
+ <key>com.apple.security.app-sandbox</key>
94
+ <true/>
95
+ <!-- Add only what the app actually uses: -->
96
+ <!-- <key>com.apple.security.network.client</key> -->
97
+ <!-- <true/> -->
98
+ </dict>
99
+ </plist>
100
+ ```
101
+
102
+ For focus/blocking features that need accessibility:
103
+
104
+ ```xml
105
+ <key>com.apple.security.temporary-exception.apple-events</key>
106
+ <array>
107
+ <string>com.apple.systemevents</string>
108
+ </array>
109
+ ```
110
+
111
+ ### 5. Accessibility Permission (Focus Detection)
112
+
113
+ To detect which app is in focus (required for distraction blocking):
114
+
115
+ ```swift
116
+ import ApplicationServices
117
+
118
+ func requestAccessibilityPermission() -> Bool {
119
+ let options: NSDictionary = [kAXTrustedCheckOptionPrompt.takeUnretainedValue() as String: true]
120
+ return AXIsProcessTrustedWithOptions(options)
121
+ }
122
+ ```
123
+
124
+ Call this on first launch and prompt the user to grant access in **System Settings → Privacy → Accessibility**.
125
+
126
+ ### 6. Sound Effects
127
+
128
+ ```swift
129
+ import AVFoundation
130
+
131
+ class SoundPlayer {
132
+ private var player: AVAudioPlayer?
133
+
134
+ func play(_ filename: String, extension ext: String = "mp3") {
135
+ guard let url = Bundle.main.url(forResource: filename, withExtension: ext) else { return }
136
+ player = try? AVAudioPlayer(contentsOf: url)
137
+ player?.play()
138
+ }
139
+ }
140
+ ```
141
+
142
+ Add sound files to the Xcode target (check **Target Membership** in file inspector).
143
+
144
+ For system sounds (no file needed):
145
+
146
+ ```swift
147
+ NSSound.beep()
148
+ // or
149
+ NSSound(named: .init("Hero"))?.play()
150
+ ```
151
+
152
+ ### 7. Keyboard Shortcuts
153
+
154
+ Global shortcuts (work when app is not focused) — requires Accessibility permission:
155
+
156
+ ```swift
157
+ NSEvent.addGlobalMonitorForEvents(matching: .keyDown) { event in
158
+ if event.modifierFlags.contains([.command, .shift]) && event.keyCode == 36 { // ⌘⇧↩
159
+ // Handle shortcut
160
+ }
161
+ }
162
+ ```
163
+
164
+ Local shortcuts (SwiftUI):
165
+
166
+ ```swift
167
+ .keyboardShortcut("s", modifiers: [.command, .shift])
168
+ ```
169
+
170
+ ### 8. Persistent State (AppStorage)
171
+
172
+ ```swift
173
+ @AppStorage("timerDuration") private var timerDuration: Double = 25 * 60
174
+ @AppStorage("soundEnabled") private var soundEnabled: Bool = true
175
+ ```
176
+
177
+ For complex state, use `UserDefaults` with a suite name to share across extensions.
178
+
179
+ ### 9. Polish Cycle
180
+
181
+ After each implementation slice:
182
+
183
+ > **Optional skills**: Steps 1 and 3 require `/critique` and `/whimsy-injector` from the agent-skills catalog. Install them via `skillshare` if not already available; skip these steps if not installed.
184
+
185
+ 1. Run `/critique` — evaluate against Apple HIG, WCAG contrast, interaction consistency
186
+ 2. Fix all P0/P1 findings
187
+ 3. Run `/whimsy-injector` on completion screens and idle states
188
+ 4. Test on a machine **without** a notch to verify layout
189
+
190
+ ### 10. App Store Preparation
191
+
192
+ See `olko:apple-store-submit` for the full submission and rejection-handling workflow.
193
+
194
+ Pre-submission checklist:
195
+
196
+ ```bash
197
+ # Validate archive
198
+ xcodebuild archive -scheme <AppName> -archivePath build/<AppName>.xcarchive
199
+
200
+ # Check sandbox
201
+ codesign --verify --deep --strict build/<AppName>.xcarchive/Products/Applications/<AppName>.app
202
+
203
+ # Verify entitlements
204
+ codesign -d --entitlements :- build/<AppName>.xcarchive/Products/Applications/<AppName>.app
205
+ ```
206
+
207
+ ## Key Pitfalls
208
+
209
+ | Symptom | Cause | Fix |
210
+ |---------|-------|-----|
211
+ | App appears in Dock | `LSUIElement` missing | Add to `Info.plist` |
212
+ | Menubar icon missing after build | Asset catalog misconfigured | Use PDF or SVG template image, tick **Template Image** |
213
+ | Crash on click | View not loaded in popover window | Add `.frame()` to `MenuBarExtra` content |
214
+ | Sound not playing | File not in target | Check Target Membership in file inspector |
215
+ | Accessibility prompt not shown | Missing entitlement | Add `temporary-exception.apple-events` or use XPC |
216
+ | Notch overlap | Hardcoded y-position | Detect `visibleFrame` vs `frame` delta |
217
+
218
+ ## Verification
219
+
220
+ - [ ] App does not appear in Dock (`LSUIElement` = true)
221
+ - [ ] MenuBarExtra icon renders as template image (respects dark/light mode)
222
+ - [ ] Sound plays on timer events
223
+ - [ ] Keyboard shortcuts respond both globally and locally
224
+ - [ ] App passes `codesign --verify --deep --strict`
225
+ - [ ] Layout correct on M1 MacBook (no notch) and M3 MacBook Pro (notch)
@@ -0,0 +1,164 @@
1
+ <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
2
+
3
+ ---
4
+ inclusion: manual
5
+ description: "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice."
6
+ ---
7
+
8
+ # MVP Oneshot
9
+
10
+ You are a senior startup engineer running a four-role prompt chain in a single pass.
11
+ Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
12
+ prompt, a trimmed scope, an execution plan, and the working vertical slice.
13
+
14
+ ## Governing mindset (applies to every phase)
15
+
16
+ - Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
17
+ - Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
18
+ - Prefer boring, reliable, already-installed choices over clever new ones.
19
+ - Call out bad assumptions out loud. Concrete implementation over theory.
20
+ - If the plan does not fit a one-week solo build, reduce it until it does.
21
+
22
+ ## Inputs
23
+
24
+ Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
25
+ deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
26
+ detail would change the build.** Otherwise infer sensible defaults and state every
27
+ assumption explicitly. Do not stall — a stated assumption beats a blocking question.
28
+
29
+ ## The chain — run all four phases in order, in one pass
30
+
31
+ Run the phases back-to-back without waiting between them. Show each phase's output,
32
+ then continue. Phases 1->2 happen before any code; phase 4 runs before and after
33
+ the build.
34
+
35
+ ### Phase 1 — Prompt Architect
36
+
37
+ Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
38
+ testable, no fluff. Emit it with these sections:
39
+
40
+ - Title
41
+ - One-sentence problem statement
42
+ - Target user
43
+ - MVP goal
44
+ - Non-goals
45
+ - Core user journeys
46
+ - Required features
47
+ - Excluded (nice-to-haves explicitly cut from the MVP)
48
+ - Suggested stack
49
+ - Data model sketch
50
+ - API sketch
51
+ - Acceptance criteria
52
+ - Risks and open questions
53
+
54
+ ### Phase 2 — Scope Cop
55
+
56
+ Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
57
+
58
+ - **Cut** — scope creep, vague requirements, anything not needed to prove value
59
+ - **Keep** — the irreducible core
60
+ - **Defer** — real but post-MVP
61
+ - **Missing clarifications** — assumptions to make explicit
62
+ - **Revised MVP Build Prompt** — implementation-ready, one-week-sized
63
+
64
+ The revised prompt from this phase is the **source of truth** for the build.
65
+
66
+ ### Phase 3 — Builder
67
+
68
+ Treat the revised prompt as source of truth. Build a working vertical slice — only
69
+ what a user needs to complete the core journey. No features outside the MVP, no
70
+ TODO stubs.
71
+ For anything ambiguous, make the smallest reasonable assumption and list it. Output:
72
+
73
+ 1. Short execution plan
74
+ 2. Exact file/module changes
75
+ 3. Implementation order (small tasks, each with acceptance criteria)
76
+ 4. Test strategy (cover the core journey end to end)
77
+ 5. Verification checklist
78
+ 6. Risks and blockers
79
+
80
+ Then implement the slice, smallest diffs that work.
81
+
82
+ ### Phase 4 — Reviewer
83
+
84
+ Sanity-check before coding and again after the slice exists. Confirm: scope still
85
+ fits one week, acceptance criteria are testable, the core journey works end to
86
+ end, no smuggled-in scope creep, assumptions are documented. Flag anything that
87
+ breaks these and fix it.
88
+
89
+ ## Reusable prompt templates
90
+
91
+ The four phases above can also be run as standalone prompts in separate sessions.
92
+ Paste the relevant block, fill the bracketed input.
93
+
94
+ ### Phase 1 template — Prompt Architect
95
+
96
+ ```prompt
97
+ You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
98
+ another agent can execute.
99
+
100
+ Input: idea, target user, business goal, constraints, tech stack, deadline,
101
+ known risks.
102
+
103
+ 1. Ask up to 5 clarifying questions only if critical details are missing.
104
+ 2. Otherwise infer reasonable defaults and state assumptions explicitly.
105
+ 3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
106
+
107
+ Output sections: Title; One-sentence problem statement; Target user; MVP goal;
108
+ Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
109
+ API sketch; Acceptance criteria; Risks and open questions.
110
+
111
+ Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
112
+ optimize for learning not elegance; be strict about scope; no generic advice.
113
+
114
+ Idea: [PASTE IDEA HERE]
115
+ ```
116
+
117
+ ### Phase 2 template — Scope Cop
118
+
119
+ ```prompt
120
+ You are Scope Cop. Remove anything that does not belong in a first version.
121
+
122
+ Find scope creep, vague requirements, missing assumptions, features to cut, and
123
+ dependencies that slow shipping. Make it something a solo founder can ship fast.
124
+
125
+ Output: What to cut; What to keep; What to defer; Missing clarifications;
126
+ Revised MVP Build Prompt (implementation-ready).
127
+
128
+ Rules: be ruthless; favor speed over completeness; if a feature is not needed to
129
+ prove value, cut it; keep the revised prompt implementation-ready.
130
+
131
+ Prompt to review: [PASTE MVP BUILD PROMPT HERE]
132
+ ```
133
+
134
+ ### Phase 3 template — Builder
135
+
136
+ ```prompt
137
+ You are Builder. Implement the MVP from the prompt below as source of truth.
138
+
139
+ Ship a working vertical slice. For ambiguity, make the smallest reasonable
140
+ assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
141
+
142
+ Output: short execution plan; exact file/module changes; implementation order;
143
+ test strategy; verification checklist; risks and blockers. Each task gets acceptance
144
+ criteria. Build only what is required to complete the core journey.
145
+
146
+ Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
147
+ ```
148
+
149
+ ### Phase 4 template — Reviewer
150
+
151
+ ```prompt
152
+ You are Reviewer. Sanity-check the plan/slice before shipping.
153
+
154
+ Confirm: scope fits one week; acceptance criteria are testable; the core journey
155
+ works end to end; no scope creep crept back in; assumptions are documented. Flag
156
+ and fix anything that breaks these.
157
+
158
+ Plan/slice to review: [PASTE PLAN OR DIFF HERE]
159
+ ```
160
+
161
+ ## When stuck or uncertain
162
+
163
+ Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
164
+ moving. The shortest path to a shippable slice is the right path.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Fetch open GitHub PRs assigned to you or requesting your review, and write a grouped, age-sorted '## PRs to review' section into today's Obsidian daily note. Idempotent — re-running replaces the section."
6
6
  ---
7
7
 
8
-
9
8
  # Obsidian PR Sync
10
9
 
11
10
  Fetch all open PRs where the user is assigned or requested as reviewer, filter out
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Bullet-journal end-of-day task migration: copy unchecked tasks from today's Obsidian daily note to the next workday's note under '## Carried over', and mark them [>] in the source. Skips weekends, idempotent."
6
6
  ---
7
7
 
8
-
9
8
  # Obsidian Task Rollover
10
9
 
11
10
  Bullet-journal–style end-of-day task migration. Unfinished tasks (`- [ ]`) from
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Prepare an open-source repository for public publishing with a minimal icon, social preview image, GitHub Pages site, README standardization, CI/CD checks, release hygiene, and optional donation setup."
6
6
  ---
7
7
 
8
-
9
8
  # open-source-publisher
10
9
 
11
10
  Use this skill to audit whether an OSS repository is ready to publish, then help only with missing or weak pieces: recognizable icon, shareable social image, GitHub Pages site, standardized README, CI/CD hygiene, release readiness, and optional donation links.
@@ -5,7 +5,6 @@ inclusion: manual
5
5
  description: "Build a full-stack web application or SaaS product from a user description using production-oriented defaults."
6
6
  ---
7
7
 
8
-
9
8
  # Product Builder
10
9
 
11
10
  You are a full-stack product builder. Your goal: **build real, working products — not prototypes**.