ClickUp Super Agent best prompting practices

This article demonstrates how to write good ClickUp Super Agent prompts.

The prompt snippets outlined below are divided into sections. In each section, there is an example of a good prompt and an optimized prompt. 

Brand new to Super Agents? Read our article What are Super Agents? before diving in.

Manually configure a Super Agent

Make sure you have all the info! Learn how to manually configure your Super Agent, including entering the prompt.

Super Agents can also be created in our natural-language builder. 

screenshot of the Super Agent builder thinking.png

Role and objective

ClickUp Super Agents are like coworkers. You can assign them a role or persona and give them tasks. Think of them as a new employee or someone new to their role.

Good prompt Optimized prompt
You are a content and insights agent focused on surfacing newly shipped product features and translating them into compelling , plain-English summaries and sales angles for young professionals who are excited about new technology, but may be non-technical. You are an insightful and creative agent focused on surfacing newly shipped product features, gathering information about those features, and translating that feature information into compelling sales angles for young professionals who are excited about new technology, but may be non‑technical.

OptimizedSuper AgentPrompt (2).gif

Why is the optimized prompt better?

The optimized prompt features rich language. For example, you are an insightful and creative agent.

  • Rich language gives the Super Agent nuance and context for tasks requiring human-like subjective reasoning, deduction, or synthesis.

The optimized prompt uses the same term for consistency and repeats terms so the Super Agent doesn't have to infer any info. For example, focused on surfacing newly shipped product features, gathering information about those features, and translating that feature information.

  • Being consistent with terms and reducing inference saves the Super Agent's brainpower for the main task.  

Scope

This part of the prompt introduces the Super Agent to the scope of their task. 

Good prompt Optimized prompt

Every week, gather feature work completed across the entire workspace over the last 7 days.

Exclude obvious bug fixes, chores, refactors, or internal‑only tasks when identified via title/labels.

Every week, gather feature work completed across the entire workspace over the last 7 days.

Stick to new product features by excluding obvious bug fixes, chores, refactors, or internal‑only tasks when identified via title/labels.

InstructionsGIF.gif

Why is the optimized prompt better?

The optimized prompt uses positive instead of negative commands. For example, stick to new product features by excluding obvious bug fixes, chores, refactors, or internal-only tasks when identified via titles/lables.

  • When you start the sentence telling the Super Agent to "exclude obvious bug fixes," it spends its brainpower thinking about bugs, rather than finding new product features. 
  • Starting with a positive, "Stick to new product features," enables the Super Agent to spend its brainpower finding new product features rather than focusing on bugs. 

Next steps

Tell the Super Agent which tools to use. For example, to scan for new product features, the Super Agent will need to have access to all or part of your Workspace. 

Learn more about creating Super Agents in ClickUp

In your prompt, tell the Super Agent how to use the tool. For example, you could tell the Super Agent, Ensure there is a task named "Weekly Product Features;" if not found, create it with the create a task tool.

Learn more about using ClickUp AI Tools

Writing guidance

This part of the prompt tells the Super Agent what to produce based on the info it has gathered. 

Good prompt  Optimized prompt 
Provide 1–3 punchy sales angles per feature using action-oriented language and specific benefits. 

Provide 1–3 punchy sales angles per feature using action-oriented language and specific benefits. 

Use the feature information you gathered to ruminate on how these features could benefit or excite young 
tech-enthusiastic customers who aren't from a technical background. 

Write in punchy, action-oriented language that paints
an engaging and exciting picture of how to sell each feature.

WritingGuidance.gif

Why is the optimized prompt better?

The optimized prompt efficiently shows cause and effect. For example, Distill the feature information you gathered into high-impact sales angles that speak directly to customer needs

  • This kind of language is useful when the Super Agent isn't using an element of your prompt enough in its output.

The optimized prompt uses cause and effect to ask the Super Agent to transform the info it's gathered into its output. For example, Use the feature information you gathered to ruminate on how these features could benefit or excite young tech-enthusiastic customers who aren't from a technical background

  • Use this kind of language when the Super Agent is fixating on one part of your prompt. 

The optimized prompt features another example of rich language: Write in punchy, action-oriented language that paints an engaging and exciting picture of how to sell each feature.

  • Use this kind of language to get the precise output you're looking for.

Output format

This part of the prompt is like a template that tells the Super Agent how to format its output. 

Good prompt Optimized prompt

Feature entries:

Name: ( Task title)

Source: Link to the task

What it is: 1–2 sentence plain‑English explanation

Feature entries format:

Name: (Feature title)

Source: Link to the task about the feature

What the feature is: (Concisely explain what the
feature is, how it functions, and how it fits into the
larger product.)
 

WhatTheFeatureIs.gif

Why is the optimized prompt better?

Both prompts provide a template with parentheses. The Super Agent will know to replace the placeholder with the content it has gathered. For example, Name: (Feature title)

The optimized prompt is much more descriptive. For example, (Concisely explain what the feature is, how it functions, and how it fits into the larger product.)

  • Use output formatting when the Super Agent will benefit from guidance rather than thinking through the format on its own. For example, structured reports, SOPs, or blogs. 

Next step

To reinforce the structure you're looking for, you can follow up this section with a summary. For example:

Output Format

Produce polished, ready‑to‑publish markdown on the weekly page. Use short paragraphs and bulleted lists. Keep each feature entry under ~120 words excluding bullets.