diff --git a/.cursor/commands/create-question.md b/.cursor/commands/create-question.md
new file mode 100644
index 0000000000..c34efdcebe
--- /dev/null
+++ b/.cursor/commands/create-question.md
@@ -0,0 +1,352 @@
+# Create New Question Element
+
+Use this command to scaffold a new question element component in `packages/survey-ui/src/elements/`.
+
+## Usage
+
+When creating a new question type (e.g., `single-select`, `rating`, `nps`), follow these steps:
+
+1. **Create the component file** `{question-type}.tsx` with this structure:
+
+```typescript
+import * as React from "react";
+import { ElementHeader } from "../components/element-header";
+import { useTextDirection } from "../hooks/use-text-direction";
+import { cn } from "../lib/utils";
+
+interface {QuestionType}Props {
+ /** Unique identifier for the element container */
+ elementId: string;
+ /** The main question or prompt text displayed as the headline */
+ headline: string;
+ /** Optional descriptive text displayed below the headline */
+ description?: string;
+ /** Unique identifier for the input/control group */
+ inputId: string;
+ /** Current value */
+ value?: {ValueType};
+ /** Callback function called when the value changes */
+ onChange: (value: {ValueType}) => void;
+ /** Whether the field is required (shows asterisk indicator) */
+ required?: boolean;
+ /** Error message to display */
+ errorMessage?: string;
+ /** Text direction: 'ltr' (left-to-right), 'rtl' (right-to-left), or 'auto' (auto-detect from content) */
+ dir?: "ltr" | "rtl" | "auto";
+ /** Whether the controls are disabled */
+ disabled?: boolean;
+ // Add question-specific props here
+}
+
+function {QuestionType}({
+ elementId,
+ headline,
+ description,
+ inputId,
+ value,
+ onChange,
+ required = false,
+ errorMessage,
+ dir = "auto",
+ disabled = false,
+ // ... question-specific props
+}: {QuestionType}Props): React.JSX.Element {
+ // Ensure value is always the correct type (handle undefined/null)
+ const currentValue = value ?? {defaultValue};
+
+ // Detect text direction from content
+ const detectedDir = useTextDirection({
+ dir,
+ textContent: [headline, description ?? "", /* add other text content from question */],
+ });
+
+ return (
+