startup-ideation-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Ameen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# StartupKit
+
+An interactive startup ideation toolkit powered by Claude Code skills. Walk through a structured brainstorming process to go from "I want to start a business" to a validated, scored business idea with a complete offer, pricing model, and go-to-market plan.
+
+## What This Is
+
+StartupKit is a set of conversational AI skills that guide you through the entire business ideation process. Instead of staring at a blank page wondering what business to start, you work through a proven sequence of frameworks -- answering questions, scoring ideas, and building your offer step by step.
+
+Each phase produces a concrete markdown artifact (worksheets, scorecards, one-pagers) that you keep, revisit, and refine.
+
+## Built On The Shoulders Of Giants
+
+This toolkit synthesizes frameworks and methodologies from:
+
+- **Alex Hormozi** -- *$100M Offers* (Grand Slam Offer framework, Value Equation, offer enhancement through Scarcity/Urgency/Bonuses/Guarantees/Naming), *$100M Money Models* (Attraction/Upsell/Downsell/Continuity offer types), *$100M Leads* (lead generation), and the *$100M Playbook* (Lead Nurture: the 4 Pillars of Availability, Speed, Personalization, and Volume)
+- **Ali Abdaal** -- The Diverge/Converge/Emerge creativity process, the Holy Trinity of business ideas (Person + Problem + Product), Craft Skills auditing, the Six P's offer framework (Person/Problem/Promise/Plan/Product/Price), the 5-phase business growth roadmap, and validation through discovery calls
+- **Taki Moore** -- The 3-question niche scoring framework (Do I like them? Can I help them? Will they pay?)
+- **Additional influences** -- Rob Fitzpatrick's *The Mom Test* (customer interview principles), MJ DeMarco's *The Millionaire Fastlane* (wealth-building lanes), James Altucher's ideation techniques, and Shapiro's 4 viable business model categories
+
+All credit for the underlying business frameworks goes to these creators. StartupKit simply packages their wisdom into an interactive workflow you can use with Claude.
+
+## The 8 Phases
+
+| # | Phase | Command | What You Do |
+|---|-------|---------|-------------|
+| 0 | Start | `/startupkit` | Create or continue a brainstorming session |
+| 1 | Diverge | `/sk-diverge` | Brainstorm skills, passions, and 50+ problems |
+| 2 | Niche | `/sk-niche` | Score and rank niche ideas (person + problem) |
+| 3 | Offer | `/sk-offer` | Build a Grand Slam Offer with the Value Equation |
+| 4 | Validate | `/sk-validate` | Plan discovery calls, outreach scripts, and MVP |
+| 5 | Money | `/sk-money` | Design pricing and your full money model |
+| 6 | Leads | `/sk-leads` | Plan lead channels and nurture sequences |
+| 7 | Skills | `/sk-skills` | Match AI-powered skills to your business |
+| 8 | Export | `/sk-export` | Generate a clean one-pager summary |
+
+You don't have to follow them in order. Jump to any phase, revisit previous ones, or skip what doesn't apply.
+
+## Quick Start
+
+### Install via npm
+
+```bash
+npx startup-ideation-kit init
+```
+
+This installs the skills into `.claude/skills/` and templates into `workspace/templates/` in your current directory. No cloning required.
+
+To remove:
+
+```bash
+npx startup-ideation-kit uninstall
+```
+
+### Or clone the repo
+
+```bash
+git clone https://github.com/mohamedameen-io/StartupKit.git
+cd StartupKit
+```
+
+### Then brainstorm
+
+1. Open Claude Code in the directory
+2. Run `/startupkit` to create a new brainstorming session
+3. Work through the phases at your own pace -- Claude guides you with questions and frameworks
+4. Each phase saves its output as a structured markdown file in `workspace/sessions/your-session/`
+5. When you're done, run `/sk-export` to get a clean one-pager
+
+### What You Get At The End
+
+A `workspace/sessions/your-session/` folder containing:
+
+```
+00-session.md        # Progress tracker
+01-diverge.md        # Your skills, passions, and problems list
+02-niches.md         # Scored and ranked niche ideas
+03-offer.md          # Complete Grand Slam Offer
+04-validation.md     # Validation plan with scripts and milestones
+05-money-model.md    # Pricing, offer ladder, and revenue projections
+06-lead-strategy.md  # Lead channels and nurture sequences
+07-skills-match.md   # AI skill recommendations
+08-one-pager.md      # Final exportable summary
+```
+
+## Project Structure
+
+```
+StartupKit/
+  .claude/skills/       # Claude Code skills (the interactive prompts)
+  workspace/
+    templates/           # Blank worksheet templates for each phase
+    sessions/            # Your brainstorming sessions (gitignored)
+  resources/             # Reference materials
+```
+
+## Requirements
+
+- [Claude Code](https://claude.ai/code) (CLI, desktop app, or IDE extension)
+- Node.js (for `npx startup-ideation-kit init` only -- not needed if you clone the repo)
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+The skill definitions and templates in this repository are open source. The business frameworks referenced belong to their respective creators (Alex Hormozi, Ali Abdaal, Taki Moore, etc.) and are used here for educational purposes.

package/bin/cli.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const SKILLS = [
+  "startupkit",
+  "sk-diverge",
+  "sk-niche",
+  "sk-offer",
+  "sk-validate",
+  "sk-money",
+  "sk-leads",
+  "sk-skills",
+  "sk-export",
+];
+
+const TEMPLATES = [
+  "session-template.md",
+  "diverge-template.md",
+  "niche-template.md",
+  "offer-template.md",
+  "validation-template.md",
+  "money-model-template.md",
+  "lead-strategy-template.md",
+  "skills-match-template.md",
+  "one-pager-template.md",
+];
+
+const command = process.argv[2];
+
+function printUsage() {
+  console.log(`
+  startupkit - Interactive startup ideation kit for Claude Code
+
+  Usage:
+    npx startupkit init       Install skills and templates into current directory
+    npx startupkit uninstall  Remove installed skills and templates
+    npx startupkit help       Show this help message
+
+  After installing, open Claude Code and run /startupkit to begin.
+  `);
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function init() {
+  const cwd = process.cwd();
+  const pkgRoot = path.resolve(__dirname, "..");
+  const skillsSrc = path.join(pkgRoot, "skills");
+  const templatesSrc = path.join(pkgRoot, "templates");
+
+  let installed = 0;
+  let skipped = 0;
+
+  // Install skills
+  for (const skill of SKILLS) {
+    const src = path.join(skillsSrc, skill);
+    const dest = path.join(cwd, ".claude", "skills", skill);
+    if (fs.existsSync(path.join(dest, "SKILL.md"))) {
+      console.log(`  skip  .claude/skills/${skill}/SKILL.md (already exists)`);
+      skipped++;
+    } else {
+      copyDir(src, dest);
+      console.log(`  add   .claude/skills/${skill}/SKILL.md`);
+      installed++;
+    }
+  }
+
+  // Install templates
+  const templatesDest = path.join(cwd, "workspace", "templates");
+  fs.mkdirSync(templatesDest, { recursive: true });
+  for (const template of TEMPLATES) {
+    const src = path.join(templatesSrc, template);
+    const dest = path.join(templatesDest, template);
+    if (fs.existsSync(dest)) {
+      console.log(`  skip  workspace/templates/${template} (already exists)`);
+      skipped++;
+    } else {
+      fs.copyFileSync(src, dest);
+      console.log(`  add   workspace/templates/${template}`);
+      installed++;
+    }
+  }
+
+  // Create sessions directory
+  const sessionsDir = path.join(cwd, "workspace", "sessions");
+  fs.mkdirSync(sessionsDir, { recursive: true });
+
+  console.log(`
+  Done! ${installed} files installed, ${skipped} skipped.
+
+  Next steps:
+    1. Open Claude Code in this directory
+    2. Run /startupkit to create a new brainstorming session
+    3. Follow the phases: /sk-diverge -> /sk-niche -> /sk-offer -> ...
+  `);
+}
+
+function uninstall() {
+  const cwd = process.cwd();
+  let removed = 0;
+
+  for (const skill of SKILLS) {
+    const dir = path.join(cwd, ".claude", "skills", skill);
+    if (fs.existsSync(dir)) {
+      fs.rmSync(dir, { recursive: true });
+      console.log(`  remove  .claude/skills/${skill}/`);
+      removed++;
+    }
+  }
+
+  for (const template of TEMPLATES) {
+    const file = path.join(cwd, "workspace", "templates", template);
+    if (fs.existsSync(file)) {
+      fs.unlinkSync(file);
+      console.log(`  remove  workspace/templates/${template}`);
+      removed++;
+    }
+  }
+
+  console.log(`\n  Done! ${removed} files removed.\n`);
+}
+
+switch (command) {
+  case "init":
+    console.log("\n  Installing StartupKit skills and templates...\n");
+    init();
+    break;
+  case "uninstall":
+    console.log("\n  Removing StartupKit skills and templates...\n");
+    uninstall();
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+  case undefined:
+    printUsage();
+    break;
+  default:
+    console.log(`\n  Unknown command: ${command}`);
+    printUsage();
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "startup-ideation-kit",
+  "version": "1.0.0",
+  "description": "Interactive startup ideation kit powered by Claude Code skills. Brainstorm, score, and validate business ideas using frameworks from $100M Offers, $100M Money Models, and more.",
+  "bin": {
+    "startupkit": "./bin/cli.js"
+  },
+  "keywords": [
+    "startup",
+    "ideation",
+    "claude-code",
+    "business",
+    "brainstorming",
+    "hormozi",
+    "offers"
+  ],
+  "author": "Mohamed Ameen",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mohamedameen-io/StartupKit.git"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "templates/"
+  ]
+}

package/skills/sk-diverge/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: sk-diverge
+description: "Phase 1: Divergent thinking. Brainstorm craft skills, passions, problems, and raw niche ideas. Goal: quantity over quality -- generate 20-50+ ideas."
+---
+
+# Phase 1: Divergent Thinking
+
+You are guiding the user through a divergent brainstorming session. The goal is QUANTITY over quality. No judging, no filtering, no "that won't work." We are thinking divergently.
+
+## Setup
+
+1. Identify the active session:
+   - Check `workspace/sessions/` for folders
+   - If exactly one exists, use it
+   - If multiple exist, ask which session to use
+   - If none exist, tell the user to run `/startupkit` first to create a session
+2. Read `workspace/templates/diverge-template.md` if it exists, for output structure reference
+3. Confirm with the user: "Ready to brainstorm? This will take 15-30 minutes. I'll ask questions one block at a time."
+
+## Interactive Flow
+
+Guide the user through 5 blocks. Ask one block at a time. Wait for their response before moving to the next. Push for volume at every step.
+
+### Block A -- Craft Skills
+
+Ask these 4 questions one at a time, collecting responses:
+
+1. "What does your employer currently pay you to do? List every skill, even the boring ones."
+2. "What do people come to you for help with? Think friends, family, colleagues."
+3. "What problems have you solved in your own life that others still struggle with?"
+4. "Look at your resume or LinkedIn -- what are you genuinely good at?"
+
+After collecting answers, summarize the skills list. Push for at least 5-10 distinct skills. If the user gives fewer, prompt: "What else? Think about soft skills, technical skills, things you take for granted."
+
+### Block B -- Passions
+
+Ask: "What do you do for fun, even when nobody's paying? What topics do you read about, watch videos about, or talk about at dinner parties?"
+
+Collect the list. No minimum, but encourage breadth.
+
+### Block C -- Skills to Learn
+
+Ask: "If time and money weren't constraints, what would you learn? What courses would you take? What skills do you wish you had?"
+
+Collect the list.
+
+### Block D -- Problems List
+
+This is the big one. Use these 5 problem-finding questions, asking one at a time:
+
+1. "What tasks in your life or work are annoying and take 5x too long?"
+2. "What expensive thing do people want but can't afford? Is there a cheaper version possible?"
+3. "What works in another country or market but doesn't exist where you are?"
+4. "What can you do NOW that you couldn't do a year ago? Think AI tools, new platforms, market shifts."
+5. "What do people around you constantly complain about?"
+
+After each question, collect responses. Then push for more:
+
+> "James Altucher says: 'If you can't think of 10 ideas, think of 20 instead.' The point is to push past the obvious. Keep going. What else?"
+
+Target: 20-50 problems minimum. Keep asking "what else?" until the user runs dry.
+
+After collecting all problems, **categorize each** using Shapiro's 4 viable business models:
+- **5x Easier**: Make an annoying task 5x easier
+- **Cheaper Version**: Less expensive version of something people want
+- **International Copy**: Copy of something that works in another country/market
+- **Product-Led Growth**: Network effect or viral loop built in
+
+A problem can fit multiple categories. Some may fit none -- that's fine, still keep them.
+
+### Block E -- Cross-Pollinate
+
+Now review the skills (Blocks A-C) and problems (Block D) together. Your job:
+
+1. Look for interesting combinations of skill + problem
+2. Suggest 10-15 possible niche ideas that combine what the user is good at / passionate about with real problems
+3. Format each as: "[Skill/Passion] + [Problem] = [Possible Niche Idea]"
+4. Ask the user: "Which of these combinations resonate? Star your top 5-10."
+
+## Key Principle
+
+**NO JUDGING at this stage.** If the user says "that's a dumb idea," redirect: "We're not filtering yet -- that's Phase 2. Right now, more is better. Write it down." Encourage wild, weird, ambitious ideas alongside practical ones.
+
+## Save Output
+
+After all 5 blocks are complete:
+
+1. Write the complete brainstorm to `workspace/sessions/{name}/01-diverge.md` with this structure:
+   - Header with session name and date
+   - Section for each block (A through E) with all collected responses
+   - Problems categorized by Shapiro's 4 models
+   - Cross-pollination combinations with user's starred favorites marked
+   - Total counts: X skills, Y passions, Z problems, W niche ideas
+
+2. Update `workspace/sessions/{name}/00-session.md`:
+   - Change Phase 1 Diverge status from `[ ] Not Started` to `[x] Complete`
+   - Set Active Phase to "Phase 2: Niche"
+   - Set Next Recommended to "Phase 2: Niche"
+
+3. Tell the user: "Diverge phase complete! You generated X skills, Y problems, and W niche ideas. When you're ready, run `/sk-niche` to score and rank your best ideas."

package/skills/sk-export/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: sk-export
+description: "Export your brainstorming session as a clean, shareable one-pager summarizing all phases."
+---
+
+# Phase 8: Session Export
+
+You are the session synthesizer. Your job is to read all phase outputs from a brainstorming session and produce a clean, shareable one-pager that captures the key decisions and plans.
+
+## Setup
+
+1. Ask the user for their session name.
+2. Read ALL session files from `workspace/sessions/{name}/`:
+   - `00-session.md` -- session metadata and progress
+   - `01-diverge.md` -- skills, passions, problems list
+   - `02-niches.md` -- scored niche ideas and Gold selection
+   - `03-offer.md` -- Grand Slam Offer details
+   - `04-validation.md` -- validation plan and scripts
+   - `05-money-model.md` -- pricing and revenue model
+   - `06-lead-strategy.md` -- lead channels and nurture plan
+   - `07-skills-match.md` -- AI skill recommendations
+3. For any files that don't exist, note the gap but proceed with what's available. Not every session completes all phases.
+
+## Synthesis Rules
+
+- **Brevity over completeness**: The one-pager should be scannable in under 2 minutes.
+- **Decisions over process**: Show what was decided, not how the decision was reached.
+- **Numbers over narrative**: Use specific figures, scores, and targets wherever possible.
+- **Actionable over abstract**: Every section should answer "what do I do next?"
+
+## One-Pager Structure
+
+Generate the following document:
+
+```markdown
+# [Business Name] -- Startup One-Pager
+> Generated: [date] | Session: [name]
+
+## The Niche
+- **Person:** [dream client avatar -- who they are, what they do]
+- **Problem:** [core pain in one sentence]
+- **Promise:** [<10 word transformation statement]
+
+## The Grand Slam Offer
+- **Name:** "[Offer Name]"
+- **Product:** [what they get -- key deliverables]
+- **Price:** $[amount]
+- **Value Equation Score:** [X]/10
+- **Guarantee:** [type and terms]
+- **Key Bonuses:** [list the top 2-3 bonuses]
+
+## Revenue Model
+- **Monthly target:** $[X] from [Y] clients
+- **Customer journey:** Attraction -> Core -> Upsell -> Continuity
+- **Year 1 LTV per client:** $[X]
+- **Year 1 projected revenue:** $[X]
+
+## Validation Plan
+- **Discovery call frame:** [Market Research / Free Coaching / Sales Call]
+- **First 10 calls target:** [who specifically, by when]
+- **MVP:** [what to build, timeline]
+- **Unfair advantages:** [top 2 strongest advantages]
+
+## Lead Strategy
+- **Primary channel:** [channel]
+- **4 Pillars score:** Availability [X] | Speed [X] | Personal [X] | Volume [X]
+- **First action this week:** [single most important next step]
+
+## AI Skills Integration
+- **Core:** [skill name and how it integrates, or N/A]
+- **Bonus:** [skill name and how it integrates, or N/A]
+- **Upsell:** [skill name and how it integrates, or N/A]
+
+---
+*Generated with StartupKit | Frameworks: $100M Offers, $100M Money Models, $100M Playbook*
+```
+
+## Handling Incomplete Sessions
+
+If some phases are missing:
+- Include every section that has data.
+- For missing sections, show: `**[Section]:** Not yet completed -- run /sk-[phase] to fill in.`
+- At the bottom, list remaining phases: "To complete this one-pager, run: /sk-validate, /sk-money"
+
+## Output
+
+1. Save the one-pager to `workspace/sessions/{name}/08-one-pager.md`.
+2. Display the full one-pager in the conversation so the user can review it immediately.
+3. Update `workspace/sessions/{name}/00-session.md`:
+   - Change Phase 8 Export status from `[ ] Not Started` to `[x] Complete`
+   - Set Session Status to "Complete" (if all phases are done) or "Exported (partial)" if some phases are missing
+4. Tell the user: "Your one-pager is ready! It's saved at `workspace/sessions/{name}/08-one-pager.md`. You can share this with co-founders, mentors, or advisors for feedback."