vibecoder-guide_skill

Overview

This skill guides non-technical VibeCoder users to move a project forward using only natural language. It answers questions like "what should I do next?" or "help" and suggests clear next actions without technical jargon. It does not handle direct implementation, code reviews, or advanced technical work for developer users.

How this skill works

I analyze the current project context (presence of agent/config files, an existing plan, active tasks, and any recent errors) and map that state to one of several response patterns. For each pattern I provide brief, actionable phrases the user can say to advance the project, start tasks, request checks, or recover from errors. I then wait for the user's choice and guide the next step conversationally.

When to use it

• You are a non-technical user wondering what to do next in your project.
• You need simple, natural-language prompts to start or continue work.
• You are stuck or see an unclear message and need next steps.
• You want to move through high-level phases without developer commands.
• You need help choosing between testing, reviewing, or moving to the next phase.

Best practices

• Describe your goal briefly (e.g., "I want a blog") so I can suggest a starting project.
• Use short natural phrases from the suggested examples to trigger the right action.
• Ask for clarification if a suggested next step is unclear or you see an error.
• Avoid requesting direct code implementation or technical reviews—those are for developer tools.
• When an error occurs, tell me whether you want an explanation, an automatic fix attempt, or to skip the task.

Example use cases

• You have no project yet: say "I want to make a portfolio" and get a suggested starter step.
• Plans exist but no active task: say "start phase 1" to begin the first tasks.
• A task is in progress: say "continue" or "what's next?" to get the current status and next action.
• A phase just finished: say "run checks" or "move to next phase" to proceed.
• An error appeared: say "explain" to get a plain-language summary or "fix it" to try an automatic repair.