codex-goal-mvp-skill 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# GOAL MVP Codex Skill
+
+Install the GOAL MVP skill for Codex.
+
+```sh
+npx codex-goal-mvp-skill
+```
+
+Then invoke it in Codex with:
+
+```text
+/goal MVP build ...
+$goal-mvp build ...
+Goal MVP: build ...
+```
+
+## Global Install
+
+```sh
+npm install -g codex-goal-mvp-skill
+goal-mvp-skill
+```
+
+## Custom Target
+
+```sh
+goal-mvp-skill --target ~/.codex/skills/goal-mvp
+```
+
+Use `--force` to overwrite an existing installation.
+
+## Publish
+
+```sh
+npm login
+npm publish --access public
+```

package/bin/codex-goal-mvp-skill.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const packageRoot = path.resolve(__dirname, "..");
+const sourceDir = path.join(packageRoot, "skill", "goal-mvp");
+
+const args = new Set(process.argv.slice(2));
+const targetArgIndex = process.argv.findIndex((arg) => arg === "--target");
+const explicitTarget =
+  targetArgIndex !== -1 ? process.argv[targetArgIndex + 1] : undefined;
+
+const targetDir = path.resolve(
+  explicitTarget || path.join(os.homedir(), ".codex", "skills", "goal-mvp"),
+);
+
+function printHelp() {
+  console.log(`GOAL MVP Codex skill installer
+
+Usage:
+  npx codex-goal-mvp-skill
+  goal-mvp-skill --target /path/to/.codex/skills/goal-mvp
+
+Options:
+  --target <dir>  Install into a custom skill directory
+  --force         Overwrite an existing installation
+  --dry-run       Print what would happen without writing files
+  --help          Show this help
+`);
+}
+
+function copyDir(from, to) {
+  fs.mkdirSync(to, { recursive: true });
+
+  for (const entry of fs.readdirSync(from, { withFileTypes: true })) {
+    const sourcePath = path.join(from, entry.name);
+    const targetPath = path.join(to, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(sourcePath, targetPath);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(sourcePath, targetPath);
+    }
+  }
+}
+
+if (args.has("--help") || args.has("-h")) {
+  printHelp();
+  process.exit(0);
+}
+
+if (!fs.existsSync(sourceDir)) {
+  console.error(`Skill source not found: ${sourceDir}`);
+  process.exit(1);
+}
+
+if (args.has("--dry-run")) {
+  console.log(`Would install GOAL MVP skill to: ${targetDir}`);
+  process.exit(0);
+}
+
+if (fs.existsSync(targetDir) && !args.has("--force")) {
+  console.error(`Target already exists: ${targetDir}`);
+  console.error("Run again with --force to overwrite it.");
+  process.exit(1);
+}
+
+fs.rmSync(targetDir, { recursive: true, force: true });
+copyDir(sourceDir, targetDir);
+
+console.log(`Installed GOAL MVP skill to: ${targetDir}`);
+console.log("Restart Codex if the skill list does not refresh automatically.");

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "codex-goal-mvp-skill",
+  "version": "0.1.0",
+  "description": "Install the GOAL MVP Codex skill.",
+  "type": "commonjs",
+  "bin": {
+    "codex-goal-mvp-skill": "./bin/codex-goal-mvp-skill.js",
+    "goal-mvp-skill": "./bin/codex-goal-mvp-skill.js"
+  },
+  "files": [
+    "bin",
+    "skill",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node ./bin/codex-goal-mvp-skill.js --dry-run"
+  },
+  "keywords": [
+    "codex",
+    "skill",
+    "mvp",
+    "goal"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/skill/goal-mvp/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: goal-mvp
+description: "Use when the user writes /goal MVP, /goal mvp, Goal MVP, GoalMvp, $GoalMvp, $goal-mvp, or asks to turn a goal, idea, app concept, startup concept, game concept, automation, plugin, or Codex skill into a small buildable MVP. This skill runs a five-step workflow: clarify with mandatory questions, scope, plan, build, verify and launch."
+---
+
+# GOAL MVP
+
+Turn a raw goal into a working MVP with a bias toward shipping something testable in the current workspace.
+
+## Core Rule
+
+Do not start building on the first response unless the user explicitly asks to skip questions. First confirm the goal with a short clarification checkpoint, then convert the user's goal into concrete scope, build the smallest useful version, verify it, and hand off the result with a demo path or next action.
+
+## First Response Rule
+
+On the first response after this skill is triggered:
+
+1. Restate the interpreted goal in one sentence.
+2. Ask exactly 3 short clarifying questions.
+3. Stop and wait for the user's answers.
+
+Only skip this checkpoint if the user writes one of these explicit bypass phrases:
+
+- "procedi senza domande"
+- "no questions"
+- "skip questions"
+- "vai diretto al build"
+
+If the user gives partial answers, make reasonable assumptions for the rest and continue to scope, plan, build, and verify.
+
+## Five-Step Workflow
+
+### 1. Clarify
+
+Extract:
+
+- target user
+- problem or desire
+- core outcome
+- constraints, stack, deadline, or format
+- success criteria
+
+Ask exactly 3 short questions before build begins. Prefer questions that change product direction:
+
+- Who is the target user?
+- What is the one output the MVP must produce?
+- What should be included or avoided in the first version?
+
+After the user answers, summarize the assumptions in 2-4 bullets and continue.
+
+### 2. Scope
+
+Define the smallest useful MVP:
+
+- one primary user journey
+- 3-5 essential features
+- explicit non-goals
+- a demoable output
+
+Prefer a narrow product that works over a broad plan. Cut dashboards, auth, payments, admin panels, AI agents, and integrations unless they are central to the goal or already present in the repo.
+
+### 3. Plan
+
+Choose an implementation path that fits the existing context:
+
+- use the current repo stack when one exists
+- for a new simple web MVP, prefer Vite/React or the repo's existing frontend setup
+- for mobile MVPs, use Expo/React Native when available
+- for games, include core loop, controls, scoring, fail/win state, and playtest
+- for AI products, include model flow, prompt boundaries, failure cases, and cost awareness
+- for skills/plugins, create valid Codex structure and validate it
+
+Provide a short plan only when it improves coordination. Then execute.
+
+### 4. Build
+
+Implement the MVP end to end:
+
+- create or edit the needed files
+- keep changes scoped
+- use existing patterns before introducing new abstractions
+- include realistic sample data when external services are not required
+- avoid fake buttons or dead-end controls in user-facing flows
+
+If the goal is a content artifact rather than software, build the artifact directly: document, deck, spreadsheet, launch post, script, or prompt pack.
+
+### 5. Verify And Launch
+
+Run the relevant checks:
+
+- build, tests, lint, or typecheck when available
+- local smoke test for apps
+- browser or screenshot verification for visual/front-end work
+- validator scripts for Codex skills
+
+Finish with:
+
+- what was built
+- how to run or view it
+- verification performed
+- next best improvements
+- launch assets when relevant, such as README notes, pitch copy, demo prompt, or X post draft
+
+## Invocation Patterns
+
+Treat these as equivalent:
+
+```text
+/goal MVP build ...
+$GoalMvp build ...
+$goal-mvp build ...
+Goal MVP: build ...
+```
+
+When the user says they want to "include /goal", explain only if needed: this skill does not patch Codex's native slash command system, but it is designed to trigger from `/goal MVP` text and explicit `$goal-mvp` invocation.
+
+## Demo Prompt Template
+
+Use this template when the user wants to test the skill in a video:
+
+```text
+/goal MVP crea una micro-SaaS per freelance web designer che trova attività locali senza sito, assegna uno score al lead e genera un messaggio outreach. Voglio una demo locale funzionante con UI curata, dati sample e CSV export.
+```
+
+## Social Launch Draft
+
+When asked to prepare a launch post, draft concise Italian copy by default:
+
+```text
+Ho creato GOAL MVP: una skill Codex che trasforma "/goal MVP ..." in un workflow completo.
+
+5 step:
+1. chiarisce l'idea
+2. taglia lo scope
+3. pianifica l'MVP
+4. builda davvero
+5. verifica e prepara il lancio
+
+La testo oggi con una demo: da idea grezza a MVP locale funzionante.
+```

package/skill/goal-mvp/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GOAL MVP"
+  short_description: "Turn goals into buildable MVPs"
+  default_prompt: "Use $goal-mvp to turn this goal into a small buildable MVP and carry it through the five-step workflow."

package/skill/goal-mvp/references/test-and-launch.md

@@ -0,0 +1,50 @@
+# GOAL MVP Test And Launch Kit
+
+## Video Test Flow
+
+Use this flow for a short demo video:
+
+1. Show the invocation:
+
+```text
+/goal MVP crea una micro-SaaS per freelance web designer che trova attività locali senza sito, assegna uno score al lead e genera un messaggio outreach. Voglio una demo locale funzionante con UI curata, dati sample e CSV export.
+```
+
+2. Show GOAL MVP extracting the target, problem, MVP scope, and success criteria.
+3. Show the 3 mandatory clarifying questions.
+4. Answer the questions briefly.
+5. Show the implementation plan.
+6. Show files being created or edited.
+7. Show the local app running.
+8. Show verification output.
+9. End on the result: "idea -> MVP testabile".
+
+## Short X Post
+
+```text
+Ho creato GOAL MVP: una skill Codex che trasforma "/goal MVP ..." in un workflow completo.
+
+Clarify -> Scope -> Plan -> Build -> Verify/Launch.
+
+Obiettivo: partire da un'idea grezza e arrivare a un MVP locale testabile, non solo a un piano.
+
+La testo oggi con una demo.
+```
+
+## Longer X Post
+
+```text
+Sto testando GOAL MVP, una skill Codex che integra il modo in cui uso /goal.
+
+Scrivo:
+"/goal MVP voglio buildare..."
+
+E la skill forza 5 step:
+1. chiarisce target e problema
+2. taglia lo scope a un MVP piccolo
+3. pianifica stack e feature
+4. implementa davvero
+5. verifica e prepara il lancio
+
+L'idea e': meno planning infinito, piu' demo locali funzionanti.
+```