@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
@@ -4,7 +4,6 @@
4
4
  description: "Set up semantic-release-npm-github-publish with stable main releases and prerelease beta releases on a beta branch."
5
5
  ---
6
6
 
7
-
8
7
  # semantic-release-beta
9
8
 
10
9
  Use this skill when a project needs a reusable beta prerelease workflow with:
@@ -4,7 +4,6 @@
4
4
  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."
5
5
  ---
6
6
 
7
-
8
7
  # Starter Rules
9
8
 
10
9
  ## Overview
@@ -4,7 +4,6 @@
4
4
  description: "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops."
5
5
  ---
6
6
 
7
-
8
7
  # viral-launch
9
8
 
10
9
  Use this skill when a user wants to launch a project, make a repo marketable, improve discoverability, or build shareable launch assets.
@@ -174,6 +174,30 @@
174
174
  "kiro"
175
175
  ]
176
176
  },
177
+ {
178
+ "name": "mvp-oneshot",
179
+ "lookupName": "olko:mvp-oneshot",
180
+ "category": "software-development",
181
+ "path": "packages/software-development/mvp-oneshot",
182
+ "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.",
183
+ "tags": [
184
+ "mvp",
185
+ "product",
186
+ "scoping",
187
+ "prompt-chain",
188
+ "planning",
189
+ "startup",
190
+ "oneshot"
191
+ ],
192
+ "adapters": [
193
+ "codex",
194
+ "claude",
195
+ "cursor",
196
+ "copilot",
197
+ "windsurf",
198
+ "kiro"
199
+ ]
200
+ },
177
201
  {
178
202
  "name": "starter-rules",
179
203
  "lookupName": "olko:starter-rules",
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "product-tools",
3
3
  "description": "Skills for building, shaping, and shipping full-stack products and SaaS applications.",
4
- "packages": ["product-builder"]
4
+ "packages": ["product-builder", "mvp-oneshot"]
5
5
  }
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "prompt-tools",
3
3
  "description": "Skills for prompt engineering, prompt quality, and prompt workflow automation.",
4
- "packages": ["promptctl"]
4
+ "packages": ["promptctl", "mvp-oneshot"]
5
5
  }
@@ -8,6 +8,7 @@
8
8
  "git-commit",
9
9
  "promptctl",
10
10
  "open-source-publisher",
11
- "product-builder"
11
+ "product-builder",
12
+ "mvp-oneshot"
12
13
  ]
13
14
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@olegkoval/agent-skills",
3
- "version": "1.13.0",
3
+ "version": "1.14.0",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Oleg Koval
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,175 @@
1
+ ---
2
+ name: mvp-oneshot
3
+ description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
4
+ license: MIT
5
+ compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
6
+ metadata:
7
+ targets: [_source-only]
8
+ author: Oleg Koval
9
+ tags:
10
+ - mvp
11
+ - product
12
+ - scoping
13
+ - prompt-chain
14
+ - planning
15
+ - startup
16
+ - oneshot
17
+ ---
18
+
19
+ # MVP Oneshot
20
+
21
+ You are a senior startup engineer running a four-role prompt chain in a single pass.
22
+ Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
23
+ prompt, a trimmed scope, an execution plan, and the working vertical slice.
24
+
25
+ ## Governing mindset (applies to every phase)
26
+
27
+ - Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
28
+ - Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
29
+ - Prefer boring, reliable, already-installed choices over clever new ones.
30
+ - Call out bad assumptions out loud. Concrete implementation over theory.
31
+ - If the plan does not fit a one-week solo build, reduce it until it does.
32
+
33
+ ## Inputs
34
+
35
+ Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
36
+ deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
37
+ detail would change the build.** Otherwise infer sensible defaults and state every
38
+ assumption explicitly. Do not stall — a stated assumption beats a blocking question.
39
+
40
+ ## The chain — run all four phases in order, in one pass
41
+
42
+ Run the phases back-to-back without waiting between them. Show each phase's output,
43
+ then continue. Phases 1->2 happen before any code; phase 4 runs before and after
44
+ the build.
45
+
46
+ ### Phase 1 — Prompt Architect
47
+
48
+ Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
49
+ testable, no fluff. Emit it with these sections:
50
+
51
+ - Title
52
+ - One-sentence problem statement
53
+ - Target user
54
+ - MVP goal
55
+ - Non-goals
56
+ - Core user journeys
57
+ - Required features
58
+ - Excluded (nice-to-haves explicitly cut from the MVP)
59
+ - Suggested stack
60
+ - Data model sketch
61
+ - API sketch
62
+ - Acceptance criteria
63
+ - Risks and open questions
64
+
65
+ ### Phase 2 — Scope Cop
66
+
67
+ Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
68
+
69
+ - **Cut** — scope creep, vague requirements, anything not needed to prove value
70
+ - **Keep** — the irreducible core
71
+ - **Defer** — real but post-MVP
72
+ - **Missing clarifications** — assumptions to make explicit
73
+ - **Revised MVP Build Prompt** — implementation-ready, one-week-sized
74
+
75
+ The revised prompt from this phase is the **source of truth** for the build.
76
+
77
+ ### Phase 3 — Builder
78
+
79
+ Treat the revised prompt as source of truth. Build a working vertical slice — only
80
+ what a user needs to complete the core journey. No features outside the MVP, no
81
+ TODO stubs.
82
+ For anything ambiguous, make the smallest reasonable assumption and list it. Output:
83
+
84
+ 1. Short execution plan
85
+ 2. Exact file/module changes
86
+ 3. Implementation order (small tasks, each with acceptance criteria)
87
+ 4. Test strategy (cover the core journey end to end)
88
+ 5. Verification checklist
89
+ 6. Risks and blockers
90
+
91
+ Then implement the slice, smallest diffs that work.
92
+
93
+ ### Phase 4 — Reviewer
94
+
95
+ Sanity-check before coding and again after the slice exists. Confirm: scope still
96
+ fits one week, acceptance criteria are testable, the core journey works end to
97
+ end, no smuggled-in scope creep, assumptions are documented. Flag anything that
98
+ breaks these and fix it.
99
+
100
+ ## Reusable prompt templates
101
+
102
+ The four phases above can also be run as standalone prompts in separate sessions.
103
+ Paste the relevant block, fill the bracketed input.
104
+
105
+ ### Phase 1 template — Prompt Architect
106
+
107
+ ```prompt
108
+ You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
109
+ another agent can execute.
110
+
111
+ Input: idea, target user, business goal, constraints, tech stack, deadline,
112
+ known risks.
113
+
114
+ 1. Ask up to 5 clarifying questions only if critical details are missing.
115
+ 2. Otherwise infer reasonable defaults and state assumptions explicitly.
116
+ 3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
117
+
118
+ Output sections: Title; One-sentence problem statement; Target user; MVP goal;
119
+ Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
120
+ API sketch; Acceptance criteria; Risks and open questions.
121
+
122
+ Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
123
+ optimize for learning not elegance; be strict about scope; no generic advice.
124
+
125
+ Idea: [PASTE IDEA HERE]
126
+ ```
127
+
128
+ ### Phase 2 template — Scope Cop
129
+
130
+ ```prompt
131
+ You are Scope Cop. Remove anything that does not belong in a first version.
132
+
133
+ Find scope creep, vague requirements, missing assumptions, features to cut, and
134
+ dependencies that slow shipping. Make it something a solo founder can ship fast.
135
+
136
+ Output: What to cut; What to keep; What to defer; Missing clarifications;
137
+ Revised MVP Build Prompt (implementation-ready).
138
+
139
+ Rules: be ruthless; favor speed over completeness; if a feature is not needed to
140
+ prove value, cut it; keep the revised prompt implementation-ready.
141
+
142
+ Prompt to review: [PASTE MVP BUILD PROMPT HERE]
143
+ ```
144
+
145
+ ### Phase 3 template — Builder
146
+
147
+ ```prompt
148
+ You are Builder. Implement the MVP from the prompt below as source of truth.
149
+
150
+ Ship a working vertical slice. For ambiguity, make the smallest reasonable
151
+ assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
152
+
153
+ Output: short execution plan; exact file/module changes; implementation order;
154
+ test strategy; verification checklist; risks and blockers. Each task gets acceptance
155
+ criteria. Build only what is required to complete the core journey.
156
+
157
+ Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
158
+ ```
159
+
160
+ ### Phase 4 template — Reviewer
161
+
162
+ ```prompt
163
+ You are Reviewer. Sanity-check the plan/slice before shipping.
164
+
165
+ Confirm: scope fits one week; acceptance criteria are testable; the core journey
166
+ works end to end; no scope creep crept back in; assumptions are documented. Flag
167
+ and fix anything that breaks these.
168
+
169
+ Plan/slice to review: [PASTE PLAN OR DIFF HERE]
170
+ ```
171
+
172
+ ## When stuck or uncertain
173
+
174
+ Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
175
+ moving. The shortest path to a shippable slice is the right path.
@@ -0,0 +1,5 @@
1
+ {
2
+ "name": "olko-mvp-oneshot",
3
+ "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.",
4
+ "skills": "./skills"
5
+ }
@@ -0,0 +1,176 @@
1
+ ---
2
+ name: mvp-oneshot
3
+ description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
4
+ license: MIT
5
+ compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
6
+ metadata:
7
+ targets: [_source-only]
8
+ author: Oleg Koval
9
+ tags:
10
+ - mvp
11
+ - product
12
+ - scoping
13
+ - prompt-chain
14
+ - planning
15
+ - startup
16
+ - oneshot
17
+ ---
18
+ <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
19
+
20
+ # MVP Oneshot
21
+
22
+ You are a senior startup engineer running a four-role prompt chain in a single pass.
23
+ Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
24
+ prompt, a trimmed scope, an execution plan, and the working vertical slice.
25
+
26
+ ## Governing mindset (applies to every phase)
27
+
28
+ - Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
29
+ - Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
30
+ - Prefer boring, reliable, already-installed choices over clever new ones.
31
+ - Call out bad assumptions out loud. Concrete implementation over theory.
32
+ - If the plan does not fit a one-week solo build, reduce it until it does.
33
+
34
+ ## Inputs
35
+
36
+ Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
37
+ deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
38
+ detail would change the build.** Otherwise infer sensible defaults and state every
39
+ assumption explicitly. Do not stall — a stated assumption beats a blocking question.
40
+
41
+ ## The chain — run all four phases in order, in one pass
42
+
43
+ Run the phases back-to-back without waiting between them. Show each phase's output,
44
+ then continue. Phases 1->2 happen before any code; phase 4 runs before and after
45
+ the build.
46
+
47
+ ### Phase 1 — Prompt Architect
48
+
49
+ Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
50
+ testable, no fluff. Emit it with these sections:
51
+
52
+ - Title
53
+ - One-sentence problem statement
54
+ - Target user
55
+ - MVP goal
56
+ - Non-goals
57
+ - Core user journeys
58
+ - Required features
59
+ - Excluded (nice-to-haves explicitly cut from the MVP)
60
+ - Suggested stack
61
+ - Data model sketch
62
+ - API sketch
63
+ - Acceptance criteria
64
+ - Risks and open questions
65
+
66
+ ### Phase 2 — Scope Cop
67
+
68
+ Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
69
+
70
+ - **Cut** — scope creep, vague requirements, anything not needed to prove value
71
+ - **Keep** — the irreducible core
72
+ - **Defer** — real but post-MVP
73
+ - **Missing clarifications** — assumptions to make explicit
74
+ - **Revised MVP Build Prompt** — implementation-ready, one-week-sized
75
+
76
+ The revised prompt from this phase is the **source of truth** for the build.
77
+
78
+ ### Phase 3 — Builder
79
+
80
+ Treat the revised prompt as source of truth. Build a working vertical slice — only
81
+ what a user needs to complete the core journey. No features outside the MVP, no
82
+ TODO stubs.
83
+ For anything ambiguous, make the smallest reasonable assumption and list it. Output:
84
+
85
+ 1. Short execution plan
86
+ 2. Exact file/module changes
87
+ 3. Implementation order (small tasks, each with acceptance criteria)
88
+ 4. Test strategy (cover the core journey end to end)
89
+ 5. Verification checklist
90
+ 6. Risks and blockers
91
+
92
+ Then implement the slice, smallest diffs that work.
93
+
94
+ ### Phase 4 — Reviewer
95
+
96
+ Sanity-check before coding and again after the slice exists. Confirm: scope still
97
+ fits one week, acceptance criteria are testable, the core journey works end to
98
+ end, no smuggled-in scope creep, assumptions are documented. Flag anything that
99
+ breaks these and fix it.
100
+
101
+ ## Reusable prompt templates
102
+
103
+ The four phases above can also be run as standalone prompts in separate sessions.
104
+ Paste the relevant block, fill the bracketed input.
105
+
106
+ ### Phase 1 template — Prompt Architect
107
+
108
+ ```prompt
109
+ You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
110
+ another agent can execute.
111
+
112
+ Input: idea, target user, business goal, constraints, tech stack, deadline,
113
+ known risks.
114
+
115
+ 1. Ask up to 5 clarifying questions only if critical details are missing.
116
+ 2. Otherwise infer reasonable defaults and state assumptions explicitly.
117
+ 3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
118
+
119
+ Output sections: Title; One-sentence problem statement; Target user; MVP goal;
120
+ Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
121
+ API sketch; Acceptance criteria; Risks and open questions.
122
+
123
+ Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
124
+ optimize for learning not elegance; be strict about scope; no generic advice.
125
+
126
+ Idea: [PASTE IDEA HERE]
127
+ ```
128
+
129
+ ### Phase 2 template — Scope Cop
130
+
131
+ ```prompt
132
+ You are Scope Cop. Remove anything that does not belong in a first version.
133
+
134
+ Find scope creep, vague requirements, missing assumptions, features to cut, and
135
+ dependencies that slow shipping. Make it something a solo founder can ship fast.
136
+
137
+ Output: What to cut; What to keep; What to defer; Missing clarifications;
138
+ Revised MVP Build Prompt (implementation-ready).
139
+
140
+ Rules: be ruthless; favor speed over completeness; if a feature is not needed to
141
+ prove value, cut it; keep the revised prompt implementation-ready.
142
+
143
+ Prompt to review: [PASTE MVP BUILD PROMPT HERE]
144
+ ```
145
+
146
+ ### Phase 3 template — Builder
147
+
148
+ ```prompt
149
+ You are Builder. Implement the MVP from the prompt below as source of truth.
150
+
151
+ Ship a working vertical slice. For ambiguity, make the smallest reasonable
152
+ assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
153
+
154
+ Output: short execution plan; exact file/module changes; implementation order;
155
+ test strategy; verification checklist; risks and blockers. Each task gets acceptance
156
+ criteria. Build only what is required to complete the core journey.
157
+
158
+ Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
159
+ ```
160
+
161
+ ### Phase 4 template — Reviewer
162
+
163
+ ```prompt
164
+ You are Reviewer. Sanity-check the plan/slice before shipping.
165
+
166
+ Confirm: scope fits one week; acceptance criteria are testable; the core journey
167
+ works end to end; no scope creep crept back in; assumptions are documented. Flag
168
+ and fix anything that breaks these.
169
+
170
+ Plan/slice to review: [PASTE PLAN OR DIFF HERE]
171
+ ```
172
+
173
+ ## When stuck or uncertain
174
+
175
+ Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
176
+ moving. The shortest path to a shippable slice is the right path.
@@ -0,0 +1,3 @@
1
+ # Codex adapter
2
+
3
+ Use the canonical skill directly from `packages/software-development/mvp-oneshot/SKILL.md`.
@@ -0,0 +1,6 @@
1
+ {
2
+ "name": "olko:mvp-oneshot",
3
+ "version": "0.1.0",
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
+ "skills": "skills/"
6
+ }
@@ -0,0 +1,176 @@
1
+ ---
2
+ name: mvp-oneshot
3
+ description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
4
+ license: MIT
5
+ compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
6
+ metadata:
7
+ targets: ["cursor"]
8
+ author: Oleg Koval
9
+ tags:
10
+ - mvp
11
+ - product
12
+ - scoping
13
+ - prompt-chain
14
+ - planning
15
+ - startup
16
+ - oneshot
17
+ ---
18
+ <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
19
+
20
+ # MVP Oneshot
21
+
22
+ You are a senior startup engineer running a four-role prompt chain in a single pass.
23
+ Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
24
+ prompt, a trimmed scope, an execution plan, and the working vertical slice.
25
+
26
+ ## Governing mindset (applies to every phase)
27
+
28
+ - Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
29
+ - Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
30
+ - Prefer boring, reliable, already-installed choices over clever new ones.
31
+ - Call out bad assumptions out loud. Concrete implementation over theory.
32
+ - If the plan does not fit a one-week solo build, reduce it until it does.
33
+
34
+ ## Inputs
35
+
36
+ Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
37
+ deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
38
+ detail would change the build.** Otherwise infer sensible defaults and state every
39
+ assumption explicitly. Do not stall — a stated assumption beats a blocking question.
40
+
41
+ ## The chain — run all four phases in order, in one pass
42
+
43
+ Run the phases back-to-back without waiting between them. Show each phase's output,
44
+ then continue. Phases 1->2 happen before any code; phase 4 runs before and after
45
+ the build.
46
+
47
+ ### Phase 1 — Prompt Architect
48
+
49
+ Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
50
+ testable, no fluff. Emit it with these sections:
51
+
52
+ - Title
53
+ - One-sentence problem statement
54
+ - Target user
55
+ - MVP goal
56
+ - Non-goals
57
+ - Core user journeys
58
+ - Required features
59
+ - Excluded (nice-to-haves explicitly cut from the MVP)
60
+ - Suggested stack
61
+ - Data model sketch
62
+ - API sketch
63
+ - Acceptance criteria
64
+ - Risks and open questions
65
+
66
+ ### Phase 2 — Scope Cop
67
+
68
+ Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
69
+
70
+ - **Cut** — scope creep, vague requirements, anything not needed to prove value
71
+ - **Keep** — the irreducible core
72
+ - **Defer** — real but post-MVP
73
+ - **Missing clarifications** — assumptions to make explicit
74
+ - **Revised MVP Build Prompt** — implementation-ready, one-week-sized
75
+
76
+ The revised prompt from this phase is the **source of truth** for the build.
77
+
78
+ ### Phase 3 — Builder
79
+
80
+ Treat the revised prompt as source of truth. Build a working vertical slice — only
81
+ what a user needs to complete the core journey. No features outside the MVP, no
82
+ TODO stubs.
83
+ For anything ambiguous, make the smallest reasonable assumption and list it. Output:
84
+
85
+ 1. Short execution plan
86
+ 2. Exact file/module changes
87
+ 3. Implementation order (small tasks, each with acceptance criteria)
88
+ 4. Test strategy (cover the core journey end to end)
89
+ 5. Verification checklist
90
+ 6. Risks and blockers
91
+
92
+ Then implement the slice, smallest diffs that work.
93
+
94
+ ### Phase 4 — Reviewer
95
+
96
+ Sanity-check before coding and again after the slice exists. Confirm: scope still
97
+ fits one week, acceptance criteria are testable, the core journey works end to
98
+ end, no smuggled-in scope creep, assumptions are documented. Flag anything that
99
+ breaks these and fix it.
100
+
101
+ ## Reusable prompt templates
102
+
103
+ The four phases above can also be run as standalone prompts in separate sessions.
104
+ Paste the relevant block, fill the bracketed input.
105
+
106
+ ### Phase 1 template — Prompt Architect
107
+
108
+ ```prompt
109
+ You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
110
+ another agent can execute.
111
+
112
+ Input: idea, target user, business goal, constraints, tech stack, deadline,
113
+ known risks.
114
+
115
+ 1. Ask up to 5 clarifying questions only if critical details are missing.
116
+ 2. Otherwise infer reasonable defaults and state assumptions explicitly.
117
+ 3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
118
+
119
+ Output sections: Title; One-sentence problem statement; Target user; MVP goal;
120
+ Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
121
+ API sketch; Acceptance criteria; Risks and open questions.
122
+
123
+ Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
124
+ optimize for learning not elegance; be strict about scope; no generic advice.
125
+
126
+ Idea: [PASTE IDEA HERE]
127
+ ```
128
+
129
+ ### Phase 2 template — Scope Cop
130
+
131
+ ```prompt
132
+ You are Scope Cop. Remove anything that does not belong in a first version.
133
+
134
+ Find scope creep, vague requirements, missing assumptions, features to cut, and
135
+ dependencies that slow shipping. Make it something a solo founder can ship fast.
136
+
137
+ Output: What to cut; What to keep; What to defer; Missing clarifications;
138
+ Revised MVP Build Prompt (implementation-ready).
139
+
140
+ Rules: be ruthless; favor speed over completeness; if a feature is not needed to
141
+ prove value, cut it; keep the revised prompt implementation-ready.
142
+
143
+ Prompt to review: [PASTE MVP BUILD PROMPT HERE]
144
+ ```
145
+
146
+ ### Phase 3 template — Builder
147
+
148
+ ```prompt
149
+ You are Builder. Implement the MVP from the prompt below as source of truth.
150
+
151
+ Ship a working vertical slice. For ambiguity, make the smallest reasonable
152
+ assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
153
+
154
+ Output: short execution plan; exact file/module changes; implementation order;
155
+ test strategy; verification checklist; risks and blockers. Each task gets acceptance
156
+ criteria. Build only what is required to complete the core journey.
157
+
158
+ Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
159
+ ```
160
+
161
+ ### Phase 4 template — Reviewer
162
+
163
+ ```prompt
164
+ You are Reviewer. Sanity-check the plan/slice before shipping.
165
+
166
+ Confirm: scope fits one week; acceptance criteria are testable; the core journey
167
+ works end to end; no scope creep crept back in; assumptions are documented. Flag
168
+ and fix anything that breaks these.
169
+
170
+ Plan/slice to review: [PASTE PLAN OR DIFF HERE]
171
+ ```
172
+
173
+ ## When stuck or uncertain
174
+
175
+ Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
176
+ moving. The shortest path to a shippable slice is the right path.