> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skarmy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Describe your idea

> Turn a rough idea into a brief the Builder can act on, working with the coach on Home.

Everything starts with a sentence you write. This page shows how to get a brief that produces the first version you actually wanted.

## Before you start

Nothing — no account, no plan, no setup. Skarmy signs you in as a guest the moment you arrive, and asks you to create an account when you open the Builder.

## Start the conversation

<Steps>
  <Step title="Open Home">
    Select **Home** in the sidebar. The heading reads **What's your idea?** — or, once your company has an identity, **What's up?** with your name.
  </Step>

  <Step title="Write your idea">
    Type into the box below the heading. Plain language is right; you are not writing a spec.

    ```text theme={null}
    A site for Kilnwork, a small ceramics studio. We run weekend
    pottery workshops and want people to see the schedule and
    register interest.
    ```

    You can attach material — images, PDFs, notes — up to five files per message.
  </Step>

  <Step title="Send it">
    Press Enter. The page becomes the conversation, and the coach replies.

    **Expected result:** your message appears in the thread and the coach responds to your specific idea, not with a generic greeting.
  </Step>
</Steps>

<Note>
  The coach follows you around the app: it is the full page on **Home** and a chat panel on the right everywhere else. Past conversations live under **Chats**, reachable from the panel's history.
</Note>

## What the coach does

The coach reacts to what is interesting or hard about your idea in your own terms, then asks a question or two per reply. The questions target real tensions — who pays versus who uses it, how you get the first customers, what "value" means here — rather than checklist items.

Answer in your own words. Two or three exchanges is usually enough.

<Tip>
  You can paste in material: a business plan, notes, competitor copy, customer feedback. The coach treats it as source material for the product.
</Tip>

## Getting a better brief

A few things reliably improve what gets built.

**Say who it is for.** "A booking site" and "a booking site for people who have never thrown a pot before" produce different products.

**Name the one thing that matters most.** If the schedule is the whole point, say so. The Builder builds the smallest complete version first, and you want it built around the right centre.

**Bring real words.** Actual class names, real prices, the way you describe your own business. The Builder writes real copy, and it writes better copy from real material.

**Say if you want to skip ahead.** "Just build it" works. The coach is a peer, not a gatekeeper.

## What else the coach can do

Sharpening ideas is the coach's first job, but it can also run errands for your company:

| Say                                          | What happens                                                                              |
| -------------------------------------------- | ----------------------------------------------------------------------------------------- |
| "call my company Kilnwork"                   | Renames the company you have open, with exactly the name you give                         |
| "remember that we fire on weekends only"     | Saves the fact durably, for your company or about you                                     |
| "every morning, tell me what needs me first" | Creates a scheduled automation — the same one you could build on the **Automations** page |
| "check my calendar for tomorrow"             | Works your connected apps, one action at a time. See [Connect your apps](/company/apps)   |

## What the coach cannot do

| Ask                                           | What happens                                                          |
| --------------------------------------------- | --------------------------------------------------------------------- |
| Anything about pricing, credits, or your plan | It points you to your account settings — it genuinely cannot see them |
| Build something                               | Only the Builder builds; the coach hands off                          |
| Off-topic requests                            | It declines in one line and steers back to your company               |

## Accept the handoff

When the idea is concrete enough, the coach summarises what it is handing over and an **Open Builder** button appears.

<Frame>
  <img src="https://mintcdn.com/skarmy/mK4kEYg8oQC9Aa5M/images/coach-handoff.jpg?fit=max&auto=format&n=mK4kEYg8oQC9Aa5M&q=85&s=cc86765166e6ab83ca1ad22d800be6a7" alt="The coach summarising the Kilnwork brief, with the Open Builder button below its reply" width="1568" height="700" data-path="images/coach-handoff.jpg" />
</Frame>

Selecting it creates the workspace and opens it. Until you select it, nothing has been built.

<Note>
  If the coach thinks your idea is a genuinely separate venture rather than part of your current company, it says so in its reply, so the new company does not surprise you.
</Note>

## Verify

* The coach's reply refers to specifics of your idea, not generic advice.
* The summary before the handoff matches what you actually want built first.
* An **Open Builder** button is visible.

If the summary is wrong, say so before selecting **Open Builder**. Correcting the brief now is much cheaper than rebuilding later.

## Troubleshooting

| Problem                                  | Fix                                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------------- |
| Selecting **Open Builder** fails         | Select it again. If it keeps failing, reload the page.                        |
| The coach keeps asking questions         | Tell it to start building. It will hand off immediately.                      |
| The brief is aimed at the wrong audience | Reply with the correction, then accept the handoff.                           |
| You want to start a different idea       | Go back to **Home** and type the new idea. The old thread stays in **Chats**. |

## Next

<Columns cols={2}>
  <Card title="Work with the Builder" icon="hammer" href="/build/work-with-the-builder">
    What happens after the handoff.
  </Card>

  <Card title="How Skarmy works" icon="diagram-project" href="/how-skarmy-works">
    The full path from idea to published site.
  </Card>
</Columns>
