help

name: help description: Get oriented with the solopreneur plugin — see your AI team, check project status, and get suggestions for what to do next. Use when you're getting started or need a refresher. argument-hint: "optional: topic (skills, team, workflow, evals, getting started)"

Help: $ARGUMENTS

The user wants to get oriented with the solopreneur plugin. Show them their AI team, where they are in the workflow, and what to do next.

Instructions

1. Route by topic (if $ARGUMENTS provided)

If the user specified a topic, jump to the relevant section:

"skills" → Skip to Step 4 (skill reference table)
"team" → Skip to Step 3 (show team + org chart)
"workflow" or "lifecycle" → Explain the product lifecycle pipeline, then show the skill table
"evals" or "testing" → Skip to Step 6 (eval system guide)
"getting started" → Run full onboarding (Steps 2, 4, 5)
Anything else → Treat as a question; answer it using the context below, then offer the full onboarding

If no arguments, run the full onboarding experience (Steps 2, 4, 5). Do NOT auto-generate the org chart — just mention it's available via /solopreneur:help team.

2. Detect project state and suggest next step

Check the .solopreneur/ directory to figure out where the user is in their journey. Scan in order:

No .solopreneur/ directory at all → Brand new! Say: "Looks like you're just getting started. Your AI team is ready to go — let's kick things off! Try /solopreneur:discover [your idea] to research and validate a product idea."
Has .solopreneur/discoveries/ with files but no .solopreneur/specs/ → Say: "You've explored some ideas. Ready to turn one into a product spec? Try /solopreneur:spec [idea]"
Has specs but no .solopreneur/backlog/ → Suggest /solopreneur:backlog [spec]
Has backlog with pending tickets but no .solopreneur/designs/ → Suggest /solopreneur:design [feature] or /solopreneur:build depending on whether the project has a UI component
Has backlog with pending tickets → Suggest /solopreneur:build [ticket] for single tickets or /solopreneur:sprint for parallel execution
Has built tickets (check backlog YAML for status: built or status: tested) → Suggest /solopreneur:review
Has reviewed work → Suggest /solopreneur:ship
Has shipped → Suggest /solopreneur:release-notes [audience]

Present the suggestion conversationally: "Here's where you left off: [context]. I'd suggest [next step] — want to do that?"

3. Show team + org chart (only on `/help team`)

This step ONLY runs when the user explicitly asks for "team" (e.g., /solopreneur:help team). It is NOT part of the default onboarding flow.

Smart caching: Before generating, check if a cached org chart already exists:

Check if .solopreneur/org-chart.html exists
If it exists, compare its last-modified timestamp against the newest file in the plugin's agents/ and skills/ directories (go up two directories from this SKILL.md to find the plugin root)
If the cache is newer than all source files → just open it: open .solopreneur/org-chart.html
If any source file is newer, or the cache doesn't exist → regenerate (see below)

Generating the org chart:

The visualize-org.py script is at scripts/visualize-org.py relative to this plugin's root. Go up two directories from this SKILL.md (skills/help/SKILL.md → skills/help/ → skills/ → plugin root) to find it.

mkdir -p .solopreneur && python3 <plugin-root>/scripts/visualize-org.py --plugin-dir <plugin-root> --marketing --output .solopreneur/org-chart.html && open .solopreneur/org-chart.html

Tell the user: "I've opened your AI team's org chart in your browser. It shows all your employees, what skills they handle, what tools they use, and how the workflow connects them. Click on any card for details."

If the open command fails (non-macOS), try xdg-open instead. If both fail, just tell the user the file path.

4. Show available skills

Present a compact reference:

Product Lifecycle (each step suggests the next):

/discover → /spec → /backlog → /design → /build → /review → /ship → /release-notes

Skill	What it does	Example
`/solopreneur:discover`	Research and validate an idea	`/solopreneur:discover meal planning app for busy parents`
`/solopreneur:spec`	Write a product requirements doc	`/solopreneur:spec [discovery file or idea]`
`/solopreneur:backlog`	Break spec into prioritized tickets	`/solopreneur:backlog [spec file]`
`/solopreneur:design`	Create UI/UX direction + HTML mockups	`/solopreneur:design [spec or feature]`
`/solopreneur:build`	Plan or build a feature	`/solopreneur:build [ticket or feature]`
`/solopreneur:review`	Multi-perspective quality review	`/solopreneur:review recent`
`/solopreneur:ship`	Quality gate + deployment	`/solopreneur:ship`
`/solopreneur:release-notes`	Audience-targeted announcements	`/solopreneur:release-notes for twitter`

Team & Utility:

Skill	What it does	Example
`/solopreneur:kickoff`	Run a team meeting with multiple agents	`/solopreneur:kickoff discovery sprint on [topic]`
`/solopreneur:sprint`	Build multiple tickets in parallel	`/solopreneur:sprint`
`/solopreneur:standup`	Daily summary of recent activity	`/solopreneur:standup`
`/solopreneur:story`	Turn your building journey into a narrative	`/solopreneur:story blog post`
`/solopreneur:scaffold`	Design your own AI org from scratch	`/solopreneur:scaffold "I am a freelance designer"`
`/solopreneur:help`	You're here!	`/solopreneur:help skills`

Want to see your team visually? Run /solopreneur:help team to open the interactive org chart.

5. Mention Claude Code concepts

End with: "If you want to understand how skills, agents, hooks, or MCP servers work under the hood, just ask me directly — I can look up the Claude Code documentation for you."

6. Eval system guide (only on `/help evals` or `/help testing`)

This step ONLY runs when the user explicitly asks for "evals" or "testing". It is NOT part of the default onboarding flow.

Present the eval system as a way to systematically improve skills:

What evals are:

Your plugin includes an automated testing system. Each skill has test cases that check whether it produces the right output. An LLM judge grades each test against specific expected behaviors.

Quick commands:

# See what tests exist (no cost — just shows test cases)
bash evals/run-evals.sh --dry

# Run evals for a specific skill
bash evals/run-evals.sh [skill-name]

# Run all evals
bash evals/run-evals.sh

# Run all skills in parallel (faster for full suite)
bash evals/run-evals.sh --parallel

# Use a stronger model for more thorough testing
EVAL_MODEL=opus bash evals/run-evals.sh [skill-name]

The improvement loop:

Run evals for a skill: bash evals/run-evals.sh [skill]
Read the judge feedback in .eval-runs/[skill]/[test-id].judge.json
Refine the skill's SKILL.md based on what failed
Re-run evals to verify the fix

Adding new test cases:

Each skill's eval.csv defines its tests. The format is:

id,should_trigger,prompt,expected_behaviors

Positive tests (should_trigger=true): Check the skill produces the right output
Negative tests (should_trigger=false): Check the skill doesn't falsely trigger
Expected behaviors: Pipe-separated, specific and countable (e.g., "Identifies at least 3 competitors")

See evals/README.md for detailed guidance on writing good test cases.

Tone

Warm and welcoming, like a coworker showing someone around the office
Use "your team" and "your employees" language — reinforce the virtual company metaphor
Keep it scannable — bullet points and tables over paragraphs
Adapt to technical level: if the user seems non-technical, explain concepts in plain language