Using Playbooks

​

Playbooks are moving to Skills

Playbooks are becoming Skills. Accounts move one at a time. New accounts will start with Skills and have no Playbooks, from October 24, 2026. When your account has moved:

• Each playbook becomes a skill with the same instructions. It keeps the playbook’s scope: an Organization playbook becomes an Organization skill, an Enterprise playbook an Enterprise skill. Find it on the Customize page, under Skills.
• Settings > Playbooks shows Playbooks have moved to skills. The list is read-only. Open a playbook to see what it was and to go to its skill.
• A macro keeps working. !macro in a prompt now runs the playbook’s skill. @skills:name works too.
• Devin’s System playbooks come as the built-in System Skills plugin. You cannot uninstall it.
• The Playbooks API keeps working. Reads return the skill’s content. Writes update the skill.

​

FAQ

What happens to !macro? It keeps working. The macro runs the skill the playbook became. In the prompt box, ! lists that skill under the macro. A macro typed in Slack, Jira, Linear, or an API prompt works the same way. The session shows Invoked skill instead of Used playbook. What happens to playbooks in schedules, automations, Jira, Linear, and the API? They keep working. A schedule, automation, Jira or Linear mapping, or API request that names a playbook (playbook_id) runs its skill. A new schedule, Jira or Linear mapping picks a skill instead. A new automation names the skill in its prompt with @skills:, as any prompt does. What happens to the Playbooks API? It keeps working. Reads return the skill’s content. Writes update the skill. Create and edit skills on the Customize page. What happens to Slack sessions? Create a new session in Slack shows a skill select where the playbook select was. !macro in a Slack message works as above. Where do I edit a playbook now? On the Customize page, under Skills, in the Playbooks plugin. Settings > Playbooks is read-only and links to each skill. Users who could manage playbooks can edit these skills. The rest of this page describes Playbooks in an account that has not moved yet.

​

How to use Playbooks

To use playbooks simply select one of the playbooks available to you: your organization’s playbooks, your enterprise’s playbooks, or Devin’s System playbooks. You’ve successfully attached a playbook if you see a blue pill appear, along with an inline component for editing the playbook before starting your session.

​

Using macros

If a playbook has a macro assigned (e.g., !data-tutorial), you can quickly attach it by typing the macro name in the prompt input box. This is a convenient shortcut when you know the macro identifier for the playbook you want to use. Once you start the session, you should see your playbook show up with a grey background in the chat with Devin!

​

Refining Playbooks

As you run a new playbook with Devin, you’ll identify opportunities to improve the instructions so that Devin can complete the task more reliably. Here are some helpful features for iterating on playbooks live:

​

Browsing Playbooks

Browse and manage playbooks at Settings > Playbooks. The page groups playbooks into tabs:

• Organization: playbooks shared within your current organization.
• Enterprise: playbooks shared across every organization in your enterprise. This tab appears at the enterprise level; from an organization, use the Looking for enterprise playbooks? link to open them.
• System: playbooks provided by Devin, available to everyone.

Each tab lists playbooks with their name, macro, creator, and last-updated date, and includes a search box. If you have permission to manage playbooks in that tab, click Create playbook to add a new one.