Think of Scribble as a boss agent. Instead of doing all the work itself, it recruits the specialists it needs from a library of agents and skills in your workspace, and hands each job to the agent or skill best suited to it. If you are new to Scribble, start with the basics.
What are agents and skills?
A skill is one procedure Scribble can run: resize an image, write a script, generate a voiceover. Skills can access various AI models as well as tools, connectors and third-party plugins.
An agent is a named specialist that holds an identity and its own reference material, and takes on a whole job rather than a single step. An agent can contain a number of skills, as well as instructions about how and when to use them.
What are agents and skills?
The dividing line is decision-making. A skill runs a recipe. An agent works out the recipe as it goes.
Scribble chooses the right combination for each request, so you never have to name either one. Choosing for yourself is quicker when you already know exactly what the job is.
Where do I find them?
Open Agents in your workspace. It has two tabs, Agents and Skills. Pencil builds and maintains some of them, and your team builds the rest. Use the search bar and filters to narrow the list by category, or to show only the ones your team has built.
How can I run a specific skill with slash commands?
Slash commands are a shortcut to a specific skill. Type / in the chat box composer to search your workspace's skills by name, then pick the one you want. Reach for this when you already know the exact job to run, rather than describing the outcome and leaving the choice to Scribble.
How do I hand a job to a specific agent?
To hand a job to a specific agent of your choosing, you have two options.
Mention it by name in your chat with Scribble, for example:
“Scribble, please use the Creative Resizer agent to resize my image to 1920 x 1080 px.”
Scribble spawns the appropriate sub-agent to work on your request in the background.
Use agent. Alternatively, open the plus menu in the chat box and choose Use agent. The agent then takes over from Scribble in Agent Chat, and you ask it for work in plain language, as you normally would.
What happened to my agents when Scribble was switched on?
When a Workspace Admin switches Scribble on, Pencil moves your team's custom agents into Scribble automatically. Nothing is lost. Some of them stay agents, and others become skills.
Why did some of my agents become skills?
Pencil sorts each one by the same question: does it decide, or does it follow a procedure?
Stays an agent. Anything that plans as it goes, picks its own skills and tools, draws on reference documents or changes course based on what it finds. A copywriting agent that writes a campaign copy pack while checking ten compliance documents stays an agent, because it has to weigh that material as it works.
Becomes a skill. Anything that runs the same steps on the same kind of input to produce the same kind of output every time.
The job it does stays the same. Only its place in your workspace changes.
Do my workflows still work?
Yes. Workflows that used an agent which became a skill keep running as before. You do not need to rebuild them.
How can I create my own agents and skills?
An agent is worth building when your team repeats a job often enough that it deserves its own name and its own reference material.
Open Agents in your workspace and select New agent. The builder has four sections:
Identity. Name your agent, write a description of up to 160 characters, and choose a category. The description is what Scribble reads when it decides which agent a job should reach, so state plainly what the agent is for and what it is not for. For example: “Writes on-brand social captions for Brand X on Instagram and TikTok. Not for long-form or email copy.”
Skills. Search for the skills your agent needs and add them. You can also create a new skill here without leaving the builder.
Instructions. These are generated from your agent's identity and its selected skills. Edit them if you want to tighten how it behaves.
Knowledge. Add up to ten documents your agent should refer to. You do not need to add brand documents, since your Brand Library is available once a chat starts. This is for agent-specialist knowledge. For example, a copywriting agent might need a company writing style guide in its knowledge base.
The pane on the right previews your agent's card and lets you test it before anyone else sees it. Save as draft keeps your configuration without making the agent available. Publish changes releases it at the scope you choose: this workspace only, or every workspace on your subscription.
How do I build a skill?
For a single procedure that other agents and skills can call, build a skill instead. Open the Skills tab and select New skill. The builder has three sections:
Definition. Name your skill and describe what it does and when to use it. Under Model Preferences, choose the image, video and audio models it should use, or leave each one on Auto.
Tools. Search for the tools your skill needs and add them.
Instructions. Set out how the skill behaves when it runs.
Test it in the right-hand pane, then save it as a draft or publish it, as with an agent.
Model Preferences list generation models only. Upscaling models such as Topaz do not appear there, but a skill that upscales still uses them.
To take a skill out of use without deleting it, open its menu and switch off Enable. This only affects your workspace.
How do tools connect?
Tools come in two kinds. Native tools are built by Pencil and work as soon as you add them. Third-party tools reach other platforms, so they need a connection first. In the tools list, a native tool shows only Add. A third-party tool also shows Connect or Enable.
If a skill needs a tool that is not connected in your workspace, an orange warning badge appears on that skill and on any agent that uses it. Hover over the badge to see which tool is missing. Connect the tool and the badge disappears.
