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

# Agent integrations and skills

> Give your Hercules Agent built-in tools like web search, connect the apps you already use, and share reusable skills across Agents.

<Note>
  Agents is in private beta, so things may change. If you hit a problem, tell us via [Support &
  feedback](/docs/company/contact).
</Note>

Integrations are what let an Agent do things, not only write text. It can search the web, keep files between runs, or reach into an app you use like Slack or Stripe. Skills are instructions you write once and reuse across Agents.

Go to **Agents** → open an Agent → **Build** → **Integrations**. Skills live on **Build** → **Skills**.

<div className="screenshot ocean">
  <img src="https://mintcdn.com/zeus-0f6dadbf/AUzCpLx0wjCzKFM0/images/agents/integrations-main.png?fit=max&auto=format&n=AUzCpLx0wjCzKFM0&q=85&s=5132a41339364246bd0d8a0f3cd02d75" alt="Agent integrations page listing the Web, File workspace, and Subagents toolkits plus a connected GitHub service" width="1842" height="698" data-path="images/agents/integrations-main.png" />
</div>

### What built-in tools can I turn on?

Each one is a toolkit (a group of tools that switch on together), so you don't have to pick tools one by one.

| Toolkit | What it does |
| - | - |
| **Web** | Search the web and read the full pages it finds |
| **File workspace** | Read and write files that stick around between runs |
| **Subagents** | Hand part of a task to a helper Agent that works with the same tools |

<Note>
  Subagents get whatever tools the Agent already has, so this one is only worth turning on alongside
  others.
</Note>

### How do I add an integration?

Click **Add integration** to open the catalog. It has three kinds of entry:

* **Built-in tools**: the ones in the table above, with no setup needed
* **Apps**: things like Slack or Stripe, which you connect once and then use
* **Custom**: services you added yourself

Filter by **Popular**, **All**, **Enabled**, **Made by Hercules**, or by category. Searching looks beyond **Popular** automatically, so you can find anything by name.

### Can I control which parts of an app the Agent uses?

Yes. Expand an integration on the Integrations page to see its tools. Each app is in one of three modes:

* **All tools**: every tool, including any the app adds later
* **Read only**: only tools that read data, including any added later
* **Custom**: exactly the tools you check. Checking or unchecking a tool switches to this mode and freezes the list, so tools added later stay off until you check them

Built-in tools expand the same way to show what each tool does.

### What is a skill?

A skill is a set of instructions saved in your Organization's skill library and shared across Agents. Write a process once instead of copying it into every Agent.

Add one on **Build** → **Skills**. Write it there, or add one from your library or the marketplace with **Add from catalog**. A skill's SKILL.md and any extra files are edited on that page.

### What if the app I need is missing?

Click **Suggest an integration** in the catalog and tell us which one you need.

### Additional FAQ

<AccordionGroup>
  <Accordion title="Do these changes go live straight away?">
    No. They're part of the Agent, so they save into a draft and go live when you **Publish**. See
    [Versions](/docs/agents/versions).
  </Accordion>

  <Accordion title="How many integrations should I add?">
    Only the ones the Agent needs. Every extra tool is one more thing it has to choose between, and
    more choices usually means worse decisions.
  </Accordion>

  <Accordion title="Can I limit what an integration is allowed to do?">
    Yes, with [Guardrails](/docs/agents/guardrails). A guardrail set to **Integration input** is checked
    before the Agent uses an integration, and can stop it. You can point it at specific integrations
    or apply it to all of them.
  </Accordion>

  <Accordion title="Do integrations cost credits?">
    Using a tool during a run adds to what that run costs, and shows up in the run's cost on
    [Analytics](/docs/agents/analytics). See [Costs and limits](/docs/agents/costs-and-limits).
  </Accordion>

  <Accordion title="Are these the same as Chat Integrations or App Integrations?">
    Same apps, connected for a different reason. [Chat Integrations](/docs/ai/chat-connectors) let Hercules
    reach your tools while you chat and build. [App Integrations](/docs/apps/app-connectors) let your
    published app reach them. Agent integrations let your own Agent reach them while it runs. Each is
    a separate connection.
  </Accordion>

  <Accordion title="What happened to Read PDF, Image search, and Image generation?">
    They were retired. All three were App Builder tools that needed a chat attachment, or saved things
    nowhere else in an Agent run could read. If an Agent still lists one, it's ignored. Older
    [versions](/docs/agents/versions) still show it in their history.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.