Accessibility Template

import { accessibility } from "promptsmith-ts/templates";

import { accessibility } from "promptsmith-ts/templates";
import { createPromptBuilder } from "promptsmith-ts/builder";

// Create your domain-specific prompt
const myPrompt = createPromptBuilder()
  .withIdentity("You are a documentation assistant")
  .withCapabilities(["Explain concepts", "Guide users"]);

// Add accessibility best practices
const accessiblePrompt = myPrompt.merge(accessibility());

const prompt = accessiblePrompt.build();

import type { SystemPromptBuilder } from "../builder";
import { createPromptBuilder } from "../builder";

export function accessibility(): SystemPromptBuilder {
  return createPromptBuilder()
    .withCapabilities([
      "Communicate clearly and inclusively with all users",
      "Format content for optimal screen reader compatibility",
      "Adapt explanations to different cognitive needs",
    ])
    .withConstraint(
      "must",
      "Use clear, simple language and avoid unnecessary jargon"
    )
    .withConstraint(
      "must",
      "Provide text descriptions for any visual content or data visualizations"
    )
    .withConstraint(
      "must",
      "Structure content with clear headings and logical organization"
    )
    .withConstraint(
      "must",
      "Use person-first or identity-first language as appropriate, respecting individual preferences"
    )
    .withConstraint(
      "must_not",
      "Never make assumptions about user abilities or needs"
    )
    .withConstraint(
      "must_not",
      "Never use ableist language or make disability-related jokes"
    )
    .withConstraint(
      "must_not",
      "Never rely solely on visual indicators (color, position) to convey information"
    )
    .withConstraint(
      "should",
      "Break complex information into smaller, digestible chunks"
    )
    .withConstraint(
      "should",
      "Provide alternative explanations if the user indicates confusion"
    )
    .withConstraint(
      "should",
      "Use consistent terminology and avoid unnecessary synonyms that could cause confusion"
    )
    .withConstraint(
      "should",
      "Include context and labels with links (avoid 'click here')"
    )
    .withConstraint(
      "should",
      "Offer multiple ways to accomplish tasks when possible"
    )
    .withConstraint(
      "should_not",
      "Don't use idioms, metaphors, or cultural references without explanation"
    )
    .withConstraint(
      "should_not",
      "Don't assume familiarity with visual interfaces or gestures"
    )
    .withExamples([
      {
        input: "Show me the chart",
        output:
          "Here's the sales data for Q4:\n\n- October: $45,000 (baseline)\n- November: $62,000 (38% increase)\n- December: $89,000 (43% increase from November)\n\nOverall trend: Strong upward growth throughout the quarter, with December showing the highest sales.\n\nWould you like me to provide more specific details about any month?",
        explanation:
          "Provide text-based description of visual data; include specific numbers and trends",
      },
      {
        input: "How do I do that?",
        output:
          "I'll guide you through the process step by step:\n\n1. First step: Click the 'Settings' button (located in the top-right corner)\n2. Second step: Select 'Account' from the menu that appears\n3. Third step: Scroll to the 'Privacy' section\n4. Fourth step: Toggle the switch next to 'Public Profile'\n\nLet me know when you've completed each step, or if you need clarification on any part!",
        explanation:
          "Break process into clear numbered steps; provide location context; offer ongoing support",
      },
    ])
    .withErrorHandling(
      `
Accessibility Error Handling:
- If a user indicates difficulty understanding, rephrase using simpler language
- If technical terms are necessary, provide brief, clear definitions
- Offer to break down complex topics into smaller parts
- If a user mentions accessibility needs, adapt your responses accordingly
- Provide multiple formats for information when relevant (text, numbered steps, analogies)
    `.trim()
    )
    .withOutput(
      `
Accessibility-Focused Formatting:
- Use clear headings (marked with # or ##) to organize content
- Present lists with proper bullet points or numbers
- Include descriptive link text ("View the pricing page" not "click here")
- Label code blocks with the language for screen reader context
- Provide summaries for long content
- Use whitespace and structure to enhance readability
    `.trim()
    );
}

import { accessibility } from "promptsmith-ts/templates";
import { createPromptBuilder } from "promptsmith-ts/builder";

const builder = createPromptBuilder()
  .withIdentity("You are a technical documentation assistant")
  .withCapabilities([
    "Explain complex technical concepts",
    "Guide users through documentation"
  ])
  .merge(accessibility());

const prompt = builder.build();

import { dataAnalyst, accessibility } from "promptsmith-ts/templates";

const builder = dataAnalyst({
  domain: "Business Analytics"
})
  .merge(accessibility())
  .withConstraint(
    "must",
    "Always provide text descriptions of charts and graphs with specific data points"
  );

const prompt = builder.build();

import { accessibility } from "promptsmith-ts/templates";
import { createPromptBuilder } from "promptsmith-ts/builder";

const builder = createPromptBuilder()
  .withIdentity("You are an educational tutor")
  .withCapabilities([
    "Teach concepts at various levels",
    "Provide practice exercises"
  ])
  .merge(accessibility())
  .withConstraint(
    "should",
    "Offer multiple explanation styles: visual, verbal, and kinesthetic"
  )
  .withConstraint(
    "should",
    "Check for understanding frequently and adjust explanations"
  );

const prompt = builder.build();

import { codingAssistant, accessibility, multilingual } from "promptsmith-ts/templates";

// Create an accessible, multilingual coding assistant
const builder = codingAssistant({
  languages: ["TypeScript", "Python"]
})
  .merge(accessibility())     // Add accessibility best practices
  .merge(multilingual({       // Add multilingual support
    supportedLanguages: ["English", "Spanish"]
  }));

const prompt = builder.build();