> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stealthgpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Cases

> Practical Stealth Agent recipes by preset, with prompt patterns and recommended options

This page is a recipe book for `POST /api/stealthify/agent`. Each recipe shows when to reach for a preset, a prompt pattern that works, and the recommended `enableFactCheck` / `enableImageGeneration` settings. For the full request schema see the [endpoint reference](/api-reference/endpoints/stealthify-agent); for end-to-end integration see the [usage guide](/api-reference/stealth-agent/guide).

<Note>
  All Stealth Agent runs charge `ceil(outputWords × 10)` Stealth API words. The recipes below note when fact-check or image generation is worth the extra latency; both add wall-clock time but do not change the billing formula.
</Note>

## Picking a preset

<CardGroup cols={3}>
  <Card title="academic" icon="graduation-cap">
    Anything that needs **citations** or a structured argument: essays, lit reviews, study materials, research drafts.
  </Card>

  <Card title="seo" icon="magnifying-glass-chart">
    Anything **published on a website** to drive search traffic: blog posts, comparison pages, evergreen guides.
  </Card>

  <Card title="social" icon="share-nodes">
    Anything **published on LinkedIn or Medium**: thought-leadership posts, founder updates, technical write-ups.
  </Card>
</CardGroup>

If your output needs to look like a webpage with H2/H3 headings → `seo`. If it needs citations → `academic`. If it needs platform voice → `social`.

## Academic

The `academic` preset is the right choice whenever the output should read as scholarly and is expected to include citations. The pipeline runs web research, drafts in academic register, optionally fact-checks, humanizes, and post-processes the markdown to insert citations in your chosen style (APA by default).

<AccordionGroup>
  <Accordion title="Student-style essay or assignment draft">
    Use as a study scaffold. Keep prompts focused on a single thesis; the agent will research and structure the argument.

    ```json theme={null}
    {
      "preset": "academic",
      "prompt": "Write a 1,200-word essay arguing that mandatory financial-literacy courses in U.S. high schools improve adult savings rates. Cover history, current evidence, and counter-arguments.",
      "enableFactCheck": true,
      "enableImageGeneration": false
    }
    ```

    **Why these options**: `enableFactCheck: true` because graded work is the highest-stakes use case for hallucinations; images are usually disallowed in academic submissions.
  </Accordion>

  <Accordion title="Literature review section">
    Useful as a starting draft you'll edit by hand. Be explicit about scope and time window.

    ```json theme={null}
    {
      "preset": "academic",
      "prompt": "Draft a literature review on the effects of high-intensity interval training (HIIT) on VO2 max in adults aged 50+. Focus on peer-reviewed studies from 2018 onward and contrast HIIT with moderate continuous training.",
      "enableFactCheck": true,
      "enableImageGeneration": false
    }
    ```

    **Why these options**: lit reviews live and die by source quality — always fact-check.
  </Accordion>

  <Accordion title="Research-paper draft (introduction + background)">
    Stealth Agent is best used for **the introduction and background sections** of a paper. The methods, results, and discussion sections need your real data.

    ```json theme={null}
    {
      "preset": "academic",
      "prompt": "Write the introduction and background sections for a paper titled 'Sleep Latency and Working-Memory Performance in University Students'. Include the gap in current research and the study's contribution.",
      "enableFactCheck": true,
      "enableImageGeneration": false
    }
    ```
  </Accordion>

  <Accordion title="Study guide / explainer">
    A lower-stakes academic use case. Fact-check is still recommended but not required if you'll review the output.

    ```json theme={null}
    {
      "preset": "academic",
      "prompt": "Create a study guide on the causes and consequences of the 2008 financial crisis suitable for undergraduate economics students. Include key terms, a timeline, and three discussion questions at the end.",
      "enableFactCheck": false,
      "enableImageGeneration": false
    }
    ```
  </Accordion>
</AccordionGroup>

## SEO

The `seo` preset combines web research with a parallel keyword-research and competitor-analysis pass before drafting. Use it for any content destined for a website where ranking matters. The output is markdown structured as a publishable article.

<AccordionGroup>
  <Accordion title="Pillar / evergreen blog post">
    The most common use case. Give the agent a clear topic and the search intent you're targeting.

    ```json theme={null}
    {
      "preset": "seo",
      "prompt": "Write a comprehensive guide on choosing between PostgreSQL and MySQL for early-stage SaaS startups. Cover use cases, performance, ecosystem, and cost. Aim for 1,800–2,200 words.",
      "enableFactCheck": true,
      "enableImageGeneration": true
    }
    ```

    **Why these options**: technical accuracy is critical for developer audiences (`enableFactCheck: true`), and inline images significantly improve dwell time on long-form posts.
  </Accordion>

  <Accordion title="Comparison / 'X vs Y' article">
    The keyword + competitor passes shine here because comparison queries are crowded.

    ```json theme={null}
    {
      "preset": "seo",
      "prompt": "Compare Stripe and Adyen for European subscription businesses processing $5M–$50M ARR. Cover fees, payment-method coverage, dashboard quality, and developer experience.",
      "enableFactCheck": true,
      "enableImageGeneration": false
    }
    ```

    **Why these options**: pricing/feature claims need verification; comparison posts read better with tables than with images.
  </Accordion>

  <Accordion title="Programmatic / template-driven landing page">
    Send a structured prompt per template variant. Keep prompts narrow so each page has unique substance.

    ```json theme={null}
    {
      "preset": "seo",
      "prompt": "Write a 900-word page titled 'How to deduct home-office expenses as a freelancer in California for tax year 2025'. Include eligibility, the simplified vs actual-expense methods, and three concrete examples.",
      "enableFactCheck": true,
      "enableImageGeneration": false
    }
    ```

    **Why these options**: tax content has high accuracy stakes — always fact-check; for thin programmatic pages, skip images to keep them lean.
  </Accordion>

  <Accordion title="Listicle ('best X for Y')">
    Listicles benefit most from competitor analysis because they share SERP space with established roundups.

    ```json theme={null}
    {
      "preset": "seo",
      "prompt": "Write 'The 7 best note-taking apps for engineers in 2026'. For each, cover platform support, markdown handling, code-block features, and pricing. Include a final recommendation.",
      "enableFactCheck": true,
      "enableImageGeneration": true
    }
    ```
  </Accordion>
</AccordionGroup>

## Social

The `social` preset requires a `platform` (`"linkedin"` or `"medium"`). Pipelines diverge: LinkedIn produces shorter, hook-driven posts; Medium produces longer narrative articles with section structure.

<AccordionGroup>
  <Accordion title="LinkedIn thought-leadership post">
    Best for founders, operators, and consultants. Be concrete about the angle and the audience.

    ```json theme={null}
    {
      "preset": "social",
      "platform": "linkedin",
      "prompt": "Post about the lessons we learned moving our 30-person engineering org from a synchronous-meeting culture to documented async standups, written in the voice of a CTO. Include one hard tradeoff.",
      "enableFactCheck": false,
      "enableImageGeneration": false
    }
    ```

    **Why these options**: opinion-based posts don't need fact-checking; LinkedIn rewards text-only posts in the feed algorithm.
  </Accordion>

  <Accordion title="LinkedIn product or launch announcement">
    Provide the actual facts in the prompt. The agent's job is voice and structure, not invention.

    ```json theme={null}
    {
      "preset": "social",
      "platform": "linkedin",
      "prompt": "Announce the launch of our open-source Postgres connection-pool library, 'Pgly'. Key facts: 30k req/s on a single c7g.large, 2-line drop-in replacement for pgbouncer, MIT-licensed, repo at github.com/example/pgly. Include a clear call to action to star the repo.",
      "enableFactCheck": false,
      "enableImageGeneration": true
    }
    ```

    **Why these options**: facts are supplied in the prompt so external fact-checking is unnecessary; an image (logo or screenshot) lifts a launch post.
  </Accordion>

  <Accordion title="Medium long-form technical write-up">
    Medium handles longer articles well — give the agent room to develop the idea.

    ```json theme={null}
    {
      "preset": "social",
      "platform": "medium",
      "prompt": "Write a Medium article titled 'Why we replaced our message queue with PostgreSQL LISTEN/NOTIFY'. Cover the original setup, three failure modes that motivated the migration, the new architecture, and the operational tradeoffs we accepted.",
      "enableFactCheck": false,
      "enableImageGeneration": true
    }
    ```

    **Why these options**: it's an opinion piece grounded in your experience, not a research piece; images break up long technical articles.
  </Accordion>

  <Accordion title="Medium tutorial">
    Tutorials benefit from fact-check when they cover external APIs that change.

    ```json theme={null}
    {
      "preset": "social",
      "platform": "medium",
      "prompt": "Tutorial: 'Streaming OpenAI completions to a React UI with the Vercel AI SDK in 2026'. Walk through project setup, the streamText API, error handling, and a working end-to-end example.",
      "enableFactCheck": true,
      "enableImageGeneration": true
    }
    ```
  </Accordion>
</AccordionGroup>

## Anti-patterns

Stealth Agent is built for **long-form, single-call generation**. Don't use it when:

* **You already have the text and only need to humanize/rephrase it.** Use `/api/stealthify` with `rephrase: true` — it's faster and a fraction of the cost.
* **You need a structured response** (JSON, classification, extraction). Stealth Agent returns markdown only.
* **You need sub-second latency** for an interactive UI. Runs take minutes; queue them as background jobs and notify the user when `result` is ready.
* **You want chat-style multi-turn refinement.** The endpoint is single-shot. Iterate by adjusting the prompt and re-running.

## Recipe checklist

Before sending any Stealth Agent request, confirm:

<Steps>
  <Step title="Pick the preset">
    Citations needed → `academic`. Web SEO → `seo`. LinkedIn or Medium → `social` with the right `platform`.
  </Step>

  <Step title="Write a focused prompt">
    State the topic, audience, and approximate length. Supply any non-public facts the agent must include verbatim.
  </Step>

  <Step title="Decide on fact-check">
    Default `false`. Turn on for graded academic work, technical claims, regulated topics (legal, medical, tax, finance), and crowded SEO niches.
  </Step>

  <Step title="Decide on image generation">
    Default `false`. Turn on for SEO long-form, Medium articles, and LinkedIn launch posts. Skip for academic submissions and thin pages.
  </Step>

  <Step title="Set a 10-minute client timeout">
    The server allows up to 600s. Most HTTP clients default lower — see the [usage guide](/api-reference/stealth-agent/guide) for snippets.
  </Step>
</Steps>