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