Pull startup project data and AI-generated build specifications from CoFounder.im. Use when a user wants to build a project that was validated and planned on...
---
name: cofounder-im
description: Pull startup project data and AI-generated build specifications from CoFounder.im. Use when a user wants to build a project that was validated and planned on CoFounder.im — lists projects, fetches the full build spec (tech stack, MVP plan, UI/UX, implementation plan, OpenClaw builder output), and helps orchestrate sub-agents to build it. Trigger phrases — "build my CoFounder project", "pull my project from cofounder.im", "use my CoFounder build spec", "start building from CoFounder", "fetch my startup plan", "build from cofounder".
version: 1.2.1
metadata:
openclaw:
requires:
env:
- COFOUNDER_API_TOKEN
bins:
- curl
- jq
primaryEnv: COFOUNDER_API_TOKEN
emoji: "\U0001F680"
homepage: https://cofounder.im/openclaw
safety:
autoApproval: false
requiresUserConfirmation: true
---
# CoFounder.im Skill
## Overview
Connect OpenClaw to [CoFounder.im](https://cofounder.im) to pull AI-validated startup projects and autonomously build them. CoFounder.im runs 20+ AI agents that validate ideas, research markets, plan MVPs, design UI/UX, and generate implementation plans. This skill lets you fetch those results and use them as the foundation for building the project.
## When to use this skill
Use this skill when the user says anything like:
- "Build my CoFounder project"
- "Pull my project from cofounder.im"
- "Use my CoFounder build spec"
- "Start building from CoFounder"
- "Fetch my startup plan from CoFounder"
- "Build [project name] from cofounder"
- "What projects do I have on CoFounder?"
- "Get the build plan for [project name]"
- "I planned a project on cofounder.im, now build it"
Do **not** use this skill for general coding tasks, project scaffolding from scratch, or anything unrelated to CoFounder.im projects.
## Safety policy
This skill fetches build specifications from a remote API (cofounder.im). To ensure safe execution:
1. **User approval required** — Always show the user a summary of the build plan and get explicit confirmation before spawning any sub-agents or running any commands.
2. **Preview before execution** — Before each phase, display the sub-agent's goal, requirements, and verification command. Ask the user to approve.
3. **No blind execution** — Do not execute the build spec verbatim. Review each phase for reasonableness before presenting it to the user.
4. **Sandboxed environment recommended** — Run builds in a dedicated directory or container. Do not build in directories containing existing projects or sensitive files.
5. **Credential scope** — This skill only requires `COFOUNDER_API_TOKEN` for the CoFounder.im API. Build plans may reference additional tools (databases, cloud CLIs, etc.) depending on the project's tech stack — the user should review and install these as needed.
6. **No network access by default** — Sub-agents should only access local files and the project repository. Any external network calls (package installs, API integrations) should be reviewed by the user.
## Core rules
- Always authenticate with the bearer token from `COFOUNDER_API_TOKEN`.
- Use `list-projects` first to show available projects and let the user choose.
- Use `get-build-spec` to pull the full build specification for the chosen project.
- The build spec contains agent outputs keyed by type (e.g., `tech_stack`, `mvp_planner`, `ui_ux_assistant`, `implementation_plan_generator`, `openclaw_builder`).
- The `openclaw_builder` output is the most important — it contains a structured multi-agent build plan designed specifically for OpenClaw.
- Parse the `openclaw_builder` output to identify sub-agent tasks, then present them to the user for approval before spawning.
- **Always get user confirmation before spawning sub-agents or running verification commands.**
## Quick start
```bash
# Set your API token (generate at https://cofounder.im/users/settings)
export COFOUNDER_API_TOKEN="cfr_your_token_here"
# List your projects
curl -s https://cofounder.im/api/v1/projects \
-H "Authorization: Bearer $COFOUNDER_API_TOKEN" | jq '.projects[] | {id, name, status}'
# Get build spec for a project
curl -s https://cofounder.im/api/v1/projects/PROJECT_ID/build-spec \
-H "Authorization: Bearer $COFOUNDER_API_TOKEN" | jq .
```
## Workflow
### Step 1: List projects
Fetch the user's projects and present them for selection:
```bash
curl -s https://cofounder.im/api/v1/projects \
-H "Authorization: Bearer $COFOUNDER_API_TOKEN" | jq .
```
Example response:
```json
{
"projects": [
{
"id": "d25165d2-26c5-43dc-b4a1-ef053bf8277d",
"name": "FitTrack",
"description": "AI-powered fitness tracking app with personalized workout plans and progress analytics",
"status": "completed",
"package_type": "basic",
"inserted_at": "2026-02-15T14:22:00Z"
},
{
"id": "a4cdfd3f-2747-4d0e-afe2-8978d8911646",
"name": "MealPlan Pro",
"description": "Smart meal planning platform with grocery list generation and nutritional tracking",
"status": "active",
"package_type": "pro",
"inserted_at": "2026-02-20T10:30:00Z"
}
]
}
```
Show the user a numbered list of projects with name, status, and description. Ask which one to build. Only projects with status `"completed"` have full build specs. Projects with status `"active"` are still being processed by CoFounder.im agents.
### Step 2: Fetch build specification
```bash
curl -s https://cofounder.im/api/v1/projects/PROJECT_ID/build-spec \
-H "Authorization: Bearer $COFOUNDER_API_TOKEN" | jq .
```
Example response (agent output values are truncated — actual values are full markdown documents):
```json
{
"project": {
"id": "d25165d2-26c5-43dc-b4a1-ef053bf8277d",
"name": "FitTrack",
"description": "AI-powered fitness tracking app with personalized workout plans and progress analytics",
"status": "completed"
},
"agent_outputs": {
"tech_stack": "## Tech Stack\n\n- Framework: Next.js 14\n- Language: TypeScript 5.3\n- Database: PostgreSQL 16\n- ORM: Prisma\n- CSS: Tailwind CSS 3.4\n...",
"mvp_planner": "## Core Features\n\n### 1. Workout Tracker\n- Log exercises with sets, reps, and weight\n- Rest timer between sets\n- Progress charts and personal records\n...",
"ui_ux_assistant": "## Design System\n\n### Colors\n- Primary: #6366f1 (Indigo)\n- Background: #f8fafc\n- Text: #1e293b\n...",
"implementation_plan_generator": "## Phase 1: Project Setup\n\n1. Initialize Next.js with TypeScript\n2. Configure PostgreSQL with Prisma ORM\n3. Set up authentication with NextAuth\n...",
"openclaw_builder": "# OpenClaw Build Plan: FitTrack\n\n## Project Overview\nAn AI-powered fitness tracking app...\n\n## Tech Stack Summary\n- Framework: Next.js 14\n...\n\n## Orchestration Plan\nTotal sub-agents: 5\nExecution order: project-setup -> database -> auth -> frontend -> testing\n...",
"idea_validator": "## Validation Summary\n\nViability Score: 7.5/10\n...",
"market_research": "## Market Analysis\n\nTarget audience: fitness enthusiasts, personal trainers, gym-goers\n...",
"competitor_analysis": "## Competitors\n\n1. Strong - workout tracking app\n..."
}
}
```
The `openclaw_builder` output is the primary input for building. Other outputs provide supporting context (tech decisions, design tokens, feature specs) that sub-agents may need.
### Step 3: Review and approve the build plan
Parse the `openclaw_builder` agent output and present the user with a summary:
1. **Show the overall plan** — project name, tech stack, number of phases, dependency graph
2. **List each sub-agent phase** — name, goal, dependencies, verification command
3. **Highlight any additional tools required** — databases, CLIs, package managers beyond curl/jq
4. **Ask the user to confirm** before proceeding to execution
Example summary to show the user:
```
Build Plan: ProjectName (6 phases)
Tech: Next.js, TypeScript, PostgreSQL
Phase 1: project-setup (no deps) — Initialize repo and install dependencies
Phase 2: database (depends: project-setup) — Create schema and migrations
Phase 3: auth (depends: project-setup) — User registration and login
Phase 4: core-features (depends: database, auth) — Main business logic
Phase 5: frontend (depends: core-features) — UI components and pages
Phase 6: testing (depends: frontend) — Test suite and verification
Additional tools needed: node, npm, psql
Proceed with this build plan? (yes/no)
```
### Step 4: Execute the build (after user approval)
For each sub-agent defined in the build plan:
1. **Show the user what will be spawned** — the sub-agent's goal, requirements, and context
2. **Get user approval** for each phase (or batch-approve all phases upfront)
3. Create the sub-agent using `sessions_spawn` with the requirements from its section
4. Include relevant context from other agent outputs (tech_stack, ui_ux_assistant, etc.)
5. Monitor sub-agent completion
6. **Show verification results** before proceeding to the next phase
**Constraints:**
- Maximum 5 concurrent sub-agents (OpenClaw limit)
- Sub-agents run at depth 1 (they cannot spawn their own sub-agents)
- Each sub-agent session is isolated — pass all needed context in the spawn instruction
- Follow the phasing in the build plan — complete Phase 1 before starting Phase 2
### Step 5: Verify and report
After all sub-agents complete:
1. Verify the project structure matches the implementation plan
2. Run any test commands specified in the build plan
3. Report completion status to the user
## API reference
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/v1/projects` | GET | List all projects for the authenticated user |
| `/api/v1/projects/:id/build-spec` | GET | Get project details and all completed agent outputs |
**Authentication:** Bearer token in the `Authorization` header.
```
Authorization: Bearer cfr_your_token_here
```
**Error responses:**
- `401` — Missing or invalid token
- `404` — Project not found or does not belong to user
- `429` — Rate limit exceeded (20 requests/minute)
## Agent output keys
| Key | Description |
|-----|-------------|
| `tech_stack` | Technology stack recommendation |
| `mvp_planner` | MVP feature plan and roadmap |
| `ui_ux_assistant` | UI/UX design system and guidelines |
| `implementation_plan_generator` | Step-by-step implementation plan |
| `openclaw_builder` | Multi-agent build specification for OpenClaw |
| `idea_validator` | Idea validation analysis |
| `market_research` | Market size and trends |
| `competitor_analysis` | Competitive landscape |
| `customer_persona` | Target customer profiles |
| `business_model` | Business model canvas |
| `monetization_strategy` | Revenue and pricing strategy |
| `go_to_market` | Go-to-market strategy |
## Additional runtime dependencies
Build plans generated by CoFounder.im may require tools beyond `curl` and `jq`, depending on the project's tech stack. Common examples:
| Tech Stack | Additional Tools |
|------------|-----------------|
| Node.js / Next.js / React | `node`, `npm` or `yarn` |
| Elixir / Phoenix | `elixir`, `mix`, `postgres` |
| Python / Django / FastAPI | `python`, `pip`, `postgres` |
| Ruby / Rails | `ruby`, `bundler`, `postgres` |
| Go | `go` |
The skill will identify required tools during the build plan review (Step 3) so you can install them before execution begins.
## Getting your API token
1. Sign up at [cofounder.im](https://cofounder.im)
2. Create a project and run the AI agents
3. Go to [Settings](https://cofounder.im/users/settings) and generate an API token
4. Configure it: `openclaw config set skills.entries.cofounder-im.env.COFOUNDER_API_TOKEN "cfr_..."`
5. Restart: `openclaw gateway restart`
don't have the plugin yet? install it then click "run inline in claude" again.