Skip to main content
Private beta: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.

​
Overview

A Skill is a reusable capability bundle. Every skill consists of two parts:
  • A SKILL.md instruction document that tells the agent “when to use it, how to use it, and what steps to follow”;
  • The allowed tools declared by the skill, plus optional supporting resource files (scripts, templates, sub-documents, etc.).
A skill is packaged as a .zip archive and uploaded to AI SRE. The archive’s root directory must contain a SKILL.md file; all other resource files can be placed anywhere inside the archive and will be read by the agent on demand during execution. Once enabled, the skill becomes visible and callable by the agent in the session. The agent can autonomously decide when to invoke a skill, or you can explicitly trigger it in the chat box with /<skill-name> (e.g., /flashduty).
The difference between Skills and MCP: MCP provides connectivity to external tools; Skills provide the methodology for orchestrating those tools to complete a category of tasks. They work together — a skill declares in SKILL.md which tools it needs, including built-in tools and MCP tools in the form mcp:server/tool.

​
SKILL.md Format

SKILL.md consists of two parts — YAML frontmatter (metadata) and a body (human-readable instructions for the agent) — separated by ---: 
---
name: skill-name
description: USE FIRST for ... — a concise description of the problem this skill solves and when to use it
version: "1.0.0"
tags:
  - tag1
  - tag2
author: author-name
license: MIT
allowed-tools: bash, read, task
---

## Instructions

The skill body goes here: execution steps, constraints, notes…
Frontmatter fields:
FieldTypeRequiredDescription
namestringYesSkill name in kebab-case (lowercase letters, digits, and hyphens only, e.g. my-skill-name), 1–64 characters. This becomes the /<skill-name> trigger word.
descriptionstringNoSkill description. This is the primary signal the agent uses to select a skill — write it as an imperative “USE FIRST / prefer-over-X” statement; the more precise it is, the more reliably the skill will be invoked.
versionstringNoVersion string, e.g. 1.0.0.
tagsstring[]NoList of tags.
authorstringNoAuthor name.
licensestringNoLicense identifier.
allowed-toolsstring[]NoList of tools this skill is allowed to use. Leave empty for no additional restrictions.
Tools can be specified in two ways:
  • Built-in tools: write the tool name directly. Available built-in tools include read, write, edit, bash, grep, glob, skill, mcp, todo, time, webfetch, web_search, and others.
  • MCP tools: write them as mcp:server/tool (e.g., mcp:my-server/query). At upload time, only the existence of the MCP server is validated; the specific tool name is verified when the MCP is loaded during a session.
The built-in flashduty skill (pre-installed for every account) is a good reference: it uses the fduty CLI to cover the entire Flashduty API, allowing the agent to investigate incidents, read AI insights, query alerts, correlate changes, and more. Use it as a template when writing your own skills.

​
Install from Marketplace

Go to Plugins → Skill and click Browse Marketplace to open the skill catalog, where you can browse and install skill templates provided by Flashduty and Anthropic with a single click.
1

Open the catalog

On the skill list page, click Browse Marketplace to open the catalog dialog, which displays all available skill templates in a card grid.
2

Search and filter

Use the search box at the top to search by name or description. The Filter in the top-right corner lets you view only “Installed” or “Not Installed” skills; Sort supports “Installed First” or “Name A–Z”.
3

Install with one click

Click the + button on any uninstalled card to install it. Installation copies the template content into your account as a regular skill entry and marks its source template (shown as a v<version> badge on the card to indicate “from Marketplace”).
4

Manage installed skills

An installed card shows a gear icon in the top-right corner. Click it to open that skill’s detail panel for management.

​
Automatic and Manual Updates

When a Marketplace template publishes a newer version, the corresponding skill entry displays a Update available badge. Whether the update is applied automatically depends on whether the skill has been modified locally:

Clean skill (unmodified)

A skill that has not been locally modified after installation is automatically updated to the latest Marketplace version when the list loads — no manual action required. A notification appears after a successful update.

Modified skill

A skill that has been locally edited or re-uploaded is skipped by auto-update to avoid overwriting your changes. It retains the Update available badge, and you must manually click to update and confirm the overwrite.
Updating a modified skill overwrites your local changes with the latest Marketplace version and cannot be undone. The UI displays an “Overwrite update” confirmation dialog — proceed with caution. After reinstalling the Marketplace version, the local-modification flag is cleared and the skill returns to a clean state, re-enrolling in automatic updates.

​
Custom Skills

In addition to installing from the Marketplace, you can upload your own skill packages. On the skill list page, click Upload Skill and fill in the form:
FieldTypeRequiredDescription
OwnerTeam / AccountYesSelect the scope for this skill: Account (visible to all members account-wide) or a specific Team (visible only to members of that team). See “Scope” below.
Zip fileFileYesA .zip archive containing SKILL.md (required) and any optional resource files. Only .zip extensions are accepted.
At upload time, the system automatically validates that: the archive is a valid zip, SKILL.md exists in the root directory, the frontmatter is parseable, name follows kebab-case naming, and all declared tools are valid (built-in tools exist, MCP servers exist). Skill names must be unique within an account — a duplicate name is rejected with a prompt to choose a different name.
All metadata other than the skill name (description, version, tags, author, tools, etc.) is parsed from SKILL.md’s frontmatter and does not need to be entered separately in the form.

​
Create in conversation (skill-creator)

Besides uploading a zip, you can create and refine skills right inside an AI SRE session. skill-creator is a Flashduty-provided Marketplace skill, pre-installed into your account by default, that exists specifically to “build skills.” Trigger it with /skill-creator in any session, or just describe what you want in natural language:
  • Create from scratch: say “help me create a skill for troubleshooting X,” or after an investigation, “turn that workflow into a skill.” skill-creator clarifies your intent, drafts the SKILL.md, optionally sets up test cases and iterates on them, and saves the result as a skill in your account once you’re happy.
  • Rewrite & optimize: click “Edit in Chat” in a skill’s detail panel to have skill-creator rewrite that skill; it can also tune the description to improve triggering accuracy.
Once the draft is ready, the agent saves it as a skill with one click; if the name conflicts with an existing skill, a “Replace” confirmation appears first.
Skill archive size limits: archives saved by the agent in-conversation are capped at 10 MB; archives uploaded via the web form or file upload in a session are capped at 100 MB.

​
Management and Inspection

The skill list displays each skill’s name (with source template badge and Update available marker), scope (account or team), version, enabled toggle, and an actions column.
Toggle using the switch in the list or the detail panel. Only enabled skills are visible to the agent; a disabled skill is invisible to the agent and cannot be invoked.
Click the edit button to update the description and owner (scope). To modify skill content, download the zip, edit it, then re-upload (this creates a new version and marks the skill as modified).
In the detail panel, select “Replace” to overwrite the current skill content with a new zip. The SkillID remains unchanged, so any existing references (e.g., /<skill-name> triggers) continue to work.
Download the complete zip package (including SKILL.md and all resource files) for offline editing or backup.
Removes the skill from the current scope. Any active sessions currently using it will continue to fail until the skill is reinstalled. This action requires confirmation.

​
Detail Panel

Click any row in the list to open the skill’s detail panel:
  • Left side: the file tree of the skill package (SKILL.md, README.md, etc. are prioritized as the default preview file).
  • Right side: content preview of the selected file, with the skill description shown at the top.
  • Header area: skill name (short reference in the form skill-xxxxxx), scope label (account / team name), source template version badge (hover to see “From Marketplace — template name v<version>”), Update available marker, author, version, and the full SkillID.
  • Actions: try in chat (injects /<skill-name> into a new session), update to latest version, edit in chat, replace, download, uninstall.
When a skill package is too large to preview, the detail panel displays the file size and suggests using “Download” instead.

​
Scope

Skills share the same two-level scope model with other resources (Knowledge Packs, MCP, Agents, environments), divided into account level and team level:
ScopeVisibility
Account levelVisible to all members account-wide
Team levelVisible only to members of that team
Edit permissions: the account owner or an account administrator can edit any skill; team members can edit team-level skills belonging to their own team. There is no “creator retains rights” exception. Rows you cannot edit appear as read-only in the list. Runtime visibility: at session start, only account-level skills and skills belonging to the team bound to the current session are loaded into the session. Skills and MCP servers from other teams are mounted into the current session on demand only after the agent reads that team’s knowledge during an investigation. The account is the sole security boundary at runtime; team is only an ownership and editing tag.

Manage Knowledge

Use DUTY.md and Knowledge Packs to provide the agent with team context and troubleshooting experience.

MCP (External Tools)

Connect external tools so skills can invoke them in SKILL.md using mcp:server/tool.

Agent

Extend AI SRE’s collaboration and task-delegation capabilities with Agents.

Console

Explicitly trigger a skill in a session with /<skill-name>, or let the agent invoke it autonomously.

Overview

Learn about AI SRE’s overall capabilities and positioning.