Write Guides

Overview

Use this skill for Remix guide chapters, especially docs/guides/app/actions/docs/chapters/*.md.

The goal is guide prose that sounds like a person walking through real Remix code: concrete, direct, slightly conversational, and careful with examples. Avoid polished filler, repeated takeaways, and abstract claims that could fit any framework.

Read First

Before editing a guide chapter:

1. Read docs/guides/app/actions/docs/chapters/01-start-here.md for voice and example style.
2. Read the target chapter completely.
3. Read adjacent chapters when the target chapter refers to earlier or later concepts.
4. If the chapter explains Remix app code, load the remix skill or relevant Remix references before inventing patterns.
5. If the task is only to identify AI-sounding prose, report findings with line numbers and do not edit unless asked.

Voice

Match 01-start-here.md:

• Start from what the reader just did or will do next.
• Use concrete files, URLs, routes, handlers, components, and responses.
• Use we for walkthrough steps and you for choices the reader controls.
• Keep paragraphs short. One idea per paragraph is usually enough.
• Explai…