[{"data":1,"prerenderedAt":14},["ShallowReactive",2],{"clay-page:\u002Fwriting\u002Fcomponents\u002Fprompts":3},{"html":4,"toc":5,"description":10,"hero":11,"list":12,"socialImage":13},"\u003Ch1 id=\"prompts\">Prompts\u003C\u002Fh1>\n\u003Cp>A prompt block suggests what to ask an AI assistant or a coding agent: set up a feature, migrate a project, write a page. Readers copy it with one click and paste it into Claude Code, Codex, Cursor or a chat.\u003C\u002Fp>\n\u003Cdiv class=\"code-block\">\u003Cpre class=\"shiki shiki-themes light-plus dark-plus\" style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4;--shiki-light-bg:#FFFFFF;--shiki-dark-bg:#1E1E1E\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">::: prompt\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">Read https:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002Fllms.txt, then add Clay\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">documentation to this repository: a clay.yaml with the project's name, a\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">docs\u002F folder with a start page, and a GitHub Pages workflow.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">:::\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy code\" aria-label=\"Copy code\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cdiv class=\"clay-prompt-aura aura not-prose\">\u003Cdiv class=\"clay-prompt code-block\">\u003Cdiv class=\"clay-prompt-title\">\u003Ci class=\"fa-solid fa-wand-magic-sparkles\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan>Suggested prompt\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"clay-prompt-text\">Read https:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002Fllms.txt, then add Clay\ndocumentation to this repository: a clay.yaml with the project's name, a\ndocs\u002F folder with a start page, and a GitHub Pages workflow.\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy prompt\" aria-label=\"Copy prompt\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cul>\n\u003Cli>\u003Cstrong>The text is copied as written\u003C\u002Fstrong>, line breaks included. It is not Markdown: \u003Ccode>**bold**\u003C\u002Fcode> stays \u003Ccode>**bold**\u003C\u002Fcode>, because that is what the agent should get.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>The title\u003C\u002Fstrong> follows the name, like for \u003Ca href=\"\u002Fclay-example-repo\u002Fwriting\u002Fcomponents\u002Fdetails\" data-route=\"\u002Fwriting\u002Fcomponents\u002Fdetails\">details\u003C\u002Fa>: \u003Ccode>::: prompt For Claude Code\u003C\u002Fcode>. Without one, it is “Suggested prompt” in the language of the page.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Search finds the text\u003C\u002Fstrong> of prompts like any other text.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"good-prompts\">\u003Ca class=\"heading-anchor\" href=\"#good-prompts\" aria-label=\"Link to this section\" data-route=\"#good-prompts\">#\u003C\u002Fa>Good prompts\u003C\u002Fh2>\n\u003Cdiv class=\"clay-steps\">\u003Col>\n\u003Cli>\u003Cstrong>Point to the docs.\u003C\u002Fstrong> Agents work best from the source: a link to the site’s \u003Ca href=\"\u002Fclay-example-repo\u002Ffeatures\u002Fai-and-agents#llmstxt\" data-route=\"\u002Ffeatures\u002Fai-and-agents#llmstxt\">llms.txt\u003C\u002Fa> or to a page’s Markdown lets them read what they need.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Say what done looks like\u003C\u002Fstrong>: the files to create, the command that has to pass, like \u003Ccode>npx clay check\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Keep the reader’s choices open.\u003C\u002Fstrong> Write the prompt so it works in their project, with their names and paths left to the agent.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003C\u002Fdiv>\n\u003Cdiv class=\"clay-prompt-aura aura not-prose\">\u003Cdiv class=\"clay-prompt code-block\">\u003Cdiv class=\"clay-prompt-title\">\u003Ci class=\"fa-solid fa-wand-magic-sparkles\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan>For a coding agent\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"clay-prompt-text\">Read https:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002Ffeatures\u002Fai-and-agents.md.\nThen use `npx clay edit` commands to give every page in docs\u002Fguides a\ndescription, and run `npx clay check --json` until it reports no problems.\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy prompt\" aria-label=\"Copy prompt\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003C\u002Fdiv>\n",[6],{"id":7,"text":8,"level":9},"good-prompts","Good prompts",2,"A suggested prompt for AI assistants and coding agents, shown as written, with a button to copy it.",null,false,"\u002F_clay\u002Fsocial\u002Fwriting\u002Fcomponents\u002Fprompts.png",1792666370518]