: Keep sentences short to avoid confusing the reader with multiple simultaneous tasks. Technical Formatting Features Good instructions are scannable and easy to navigate:
To produce a proper feature for "Files Instruction," you should focus on , logical hierarchy , and visual reinforcement . Whether you are writing a manual for users or configuring a codebase instruction file (like a .instructions.md or CLAUDE.md ), the goal is to reduce cognitive load. Core Writing Principles
: Use these for sequential steps where the order of operations is critical. Files Instruction
Example: "From the tab, select New then Blank Document . This launches a fresh workspace".
: Use consistent phrasing for headings (e.g., "Creating a File," "Saving a File") to help users find information quickly. : Keep sentences short to avoid confusing the
: Apply bold formatting for UI elements (buttons, menus) that the user must interact with.
If your instruction topic covers how to handle files, include these best practices: Prompting best practices - Claude API Docs Core Writing Principles : Use these for sequential
: Include screenshots, flowcharts, or diagrams to break up dense text and illustrate complex workflows. File Management Standards