@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.
- package/.claude-plugin/plugin.json +6 -2
- package/.cursor-plugin/index.json +15 -0
- package/.kiro/steering/apple-store-submit.md +145 -0
- package/.kiro/steering/cloudflare-block-countries.md +0 -1
- package/.kiro/steering/docs-index-keeper.md +0 -1
- package/.kiro/steering/fill-music-player.md +0 -1
- package/.kiro/steering/gallery.md +0 -1
- package/.kiro/steering/gh-cli.md +0 -1
- package/.kiro/steering/git-commit.md +0 -1
- package/.kiro/steering/macos-menubar-app.md +225 -0
- package/.kiro/steering/mvp-oneshot.md +164 -0
- package/.kiro/steering/obsidian-pr-sync.md +0 -1
- package/.kiro/steering/obsidian-task-rollover.md +0 -1
- package/.kiro/steering/open-source-publisher.md +0 -1
- package/.kiro/steering/product-builder.md +0 -1
- package/.kiro/steering/promptctl.md +0 -1
- package/.kiro/steering/review-past-performance.md +0 -1
- package/.kiro/steering/search-console-indexing-audit.md +0 -1
- package/.kiro/steering/semantic-release-beta.md +0 -1
- package/.kiro/steering/starter-rules.md +0 -1
- package/.kiro/steering/viral-launch.md +0 -1
- package/.windsurf/rules/apple-store-submit.md +144 -0
- package/.windsurf/rules/cloudflare-block-countries.md +0 -1
- package/.windsurf/rules/docs-index-keeper.md +0 -1
- package/.windsurf/rules/fill-music-player.md +0 -1
- package/.windsurf/rules/gallery.md +0 -1
- package/.windsurf/rules/gh-cli.md +0 -1
- package/.windsurf/rules/git-commit.md +0 -1
- package/.windsurf/rules/macos-menubar-app.md +224 -0
- package/.windsurf/rules/mvp-oneshot.md +163 -0
- package/.windsurf/rules/obsidian-pr-sync.md +0 -1
- package/.windsurf/rules/obsidian-task-rollover.md +0 -1
- package/.windsurf/rules/open-source-publisher.md +0 -1
- package/.windsurf/rules/product-builder.md +0 -1
- package/.windsurf/rules/promptctl.md +0 -1
- package/.windsurf/rules/review-past-performance.md +0 -1
- package/.windsurf/rules/search-console-indexing-audit.md +0 -1
- package/.windsurf/rules/semantic-release-beta.md +0 -1
- package/.windsurf/rules/starter-rules.md +0 -1
- package/.windsurf/rules/viral-launch.md +0 -1
- package/catalog/skills.json +90 -0
- package/collections/product-tools.json +1 -1
- package/collections/prompt-tools.json +1 -1
- package/collections/software-development.json +2 -1
- package/package.json +1 -1
- package/packages/software-development/apple-store-submit/SKILL.md +157 -0
- package/packages/software-development/apple-store-submit/adapters/claude/plugin.json +5 -0
- package/packages/software-development/apple-store-submit/adapters/claude/skills/apple-store-submit/SKILL.md +158 -0
- package/packages/software-development/apple-store-submit/adapters/codex/README.md +3 -0
- package/packages/software-development/apple-store-submit/adapters/cursor/plugin.json +6 -0
- package/packages/software-development/apple-store-submit/adapters/cursor/skills/apple-store-submit/SKILL.md +158 -0
- package/packages/software-development/apple-store-submit/adapters/kiro/steering/apple-store-submit.md +145 -0
- package/packages/software-development/apple-store-submit/adapters/windsurf/rules/apple-store-submit.md +144 -0
- package/packages/software-development/macos-menubar-app/SKILL.md +237 -0
- package/packages/software-development/macos-menubar-app/adapters/claude/plugin.json +5 -0
- package/packages/software-development/macos-menubar-app/adapters/claude/skills/macos-menubar-app/SKILL.md +238 -0
- package/packages/software-development/macos-menubar-app/adapters/codex/README.md +3 -0
- package/packages/software-development/macos-menubar-app/adapters/cursor/plugin.json +6 -0
- package/packages/software-development/macos-menubar-app/adapters/cursor/skills/macos-menubar-app/SKILL.md +238 -0
- package/packages/software-development/macos-menubar-app/adapters/kiro/steering/macos-menubar-app.md +225 -0
- package/packages/software-development/macos-menubar-app/adapters/windsurf/rules/macos-menubar-app.md +224 -0
- package/packages/software-development/mvp-oneshot/LICENSE +21 -0
- package/packages/software-development/mvp-oneshot/SKILL.md +175 -0
- package/packages/software-development/mvp-oneshot/adapters/claude/plugin.json +5 -0
- package/packages/software-development/mvp-oneshot/adapters/claude/skills/mvp-oneshot/SKILL.md +176 -0
- package/packages/software-development/mvp-oneshot/adapters/codex/README.md +3 -0
- package/packages/software-development/mvp-oneshot/adapters/cursor/plugin.json +6 -0
- package/packages/software-development/mvp-oneshot/adapters/cursor/skills/mvp-oneshot/SKILL.md +176 -0
- package/packages/software-development/mvp-oneshot/adapters/kiro/steering/mvp-oneshot.md +164 -0
- package/packages/software-development/mvp-oneshot/adapters/windsurf/rules/mvp-oneshot.md +163 -0
- package/packages/software-development/skill-budget-audit/SKILL.md +145 -0
- package/packages/software-development/skill-budget-audit/adapters/claude/plugin.json +5 -0
- package/packages/software-development/skill-budget-audit/adapters/claude/skills/skill-budget-audit/SKILL.md +146 -0
- 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.
|
|
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.
|
package/.kiro/steering/gh-cli.md
CHANGED
|
@@ -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**.
|