@olegkoval/agent-skills 1.13.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 (55) hide show
  1. package/.claude-plugin/plugin.json +2 -1
  2. package/.cursor-plugin/index.json +5 -0
  3. package/.kiro/steering/apple-store-submit.md +0 -1
  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 +0 -1
  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 +0 -1
  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 +0 -1
  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 +24 -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/mvp-oneshot/LICENSE +21 -0
  47. package/packages/software-development/mvp-oneshot/SKILL.md +175 -0
  48. package/packages/software-development/mvp-oneshot/adapters/claude/plugin.json +5 -0
  49. package/packages/software-development/mvp-oneshot/adapters/claude/skills/mvp-oneshot/SKILL.md +176 -0
  50. package/packages/software-development/mvp-oneshot/adapters/codex/README.md +3 -0
  51. package/packages/software-development/mvp-oneshot/adapters/cursor/plugin.json +6 -0
  52. package/packages/software-development/mvp-oneshot/adapters/cursor/skills/mvp-oneshot/SKILL.md +176 -0
  53. package/packages/software-development/mvp-oneshot/adapters/kiro/steering/mvp-oneshot.md +164 -0
  54. package/packages/software-development/mvp-oneshot/adapters/windsurf/rules/mvp-oneshot.md +163 -0
  55. package/scripts/build-adapters.sh +3 -3
@@ -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.12.0",
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",
@@ -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",
@@ -5,7 +5,6 @@ inclusion: manual
5
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
6
  ---
7
7
 
8
-
9
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)*
10
9
 
11
10
  # Apple App Store Submission & Rejection Handling
@@ -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
@@ -5,7 +5,6 @@ inclusion: manual
5
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
6
  ---
7
7
 
8
-
9
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)*
10
9
 
11
10
  # macOS Menubar / Notch App (SwiftUI)
@@ -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**.
@@ -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.
@@ -4,7 +4,6 @@
4
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
5
  ---
6
6
 
7
-
8
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)*
9
8
 
10
9
  # Apple App Store Submission & Rejection Handling
@@ -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
@@ -4,7 +4,6 @@
4
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
5
  ---
6
6
 
7
-
8
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)*
9
8
 
10
9
  # macOS Menubar / Notch App (SwiftUI)
@@ -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.
@@ -4,7 +4,6 @@
4
4
  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."
5
5
  ---
6
6
 
7
-
8
7
  # /review-past-performance
9
8
 
10
9
  Self-improvement loop. Analyze recent sessions, find durable patterns, propose fixes.
@@ -4,7 +4,6 @@
4
4
  description: "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
5
5
  ---
6
6
 
7
-
8
7
  # search-console-indexing-audit
9
8
 
10
9
  Use this skill to turn Google Search Console Coverage exports into a concrete indexing fix plan.