Skip to main content
A skill is a folder of instructions and reference files that an agent reads before a task the skill covers. A skill can also carry workspace secrets, so the agent can call the API it describes. Skills belong to the workspace, and any automation can use them. Skills follow the Agent Skills format. A skill folder written for Claude Code or Codex, with a SKILL.md and its files, can be uploaded as is.

​
The skills list

Open Skills in the sidebar. Each row shows the skill’s name and description, its file count, its secrets, how many automations use it (Used by), and when it was last updated. Click a row to edit the skill.

​
Create a skill

1

Start a skill

On the Skills page, click Create skill.
2

Fill in the details

Under Details, enter a Name and a Description. The name uses lowercase letters, numbers, and single hyphens, such as billing-api. The description tells the agent when to use the skill.
3

Write the instructions

Under Instructions, explain how to do the task: for an API, the base URL, how to authenticate, the endpoints that matter, and examples.
4

Add reference files

Under Reference files, click Add files, such as an OpenAPI spec. Files keep their names inside the skill folder.
5

Add secrets

Under Secrets, click Add secret and pick a workspace secret, or choose Create a secret to store a new one. See Workspace secrets.
6

Save

Click Save.
To import an existing skill, click Upload folder and choose a folder that contains a SKILL.md. Superlog reads the name and description from its front matter and the rest as instructions. The folder’s other text files become reference files. Hidden files are left out. Binary files and unsupported file names are skipped, and the editor lists what it skipped.
Skill text is stored as written, and the agent can read it. If the instructions or a file look like they contain a credential, the editor warns you. Store keys as workspace secrets instead.

​
Use a skill in an automation

1

Open the connector picker

In the automation editor, under Connectors, click Add connector.
2

Pick the skill

Choose the skill under Skills. To make a new one, choose Create a skill. It opens in a new tab, and the picker lists it when you return.
Selected skills appear under Connectors. Click Manage to open a skill, or the trash icon to remove it from the automation. An automation can use up to 20 skills.

​
How runs use skills

At the start of each turn, Superlog writes every skill the automation uses into the sandbox at .responder/skills/<name>/. The folder holds the SKILL.md and the reference files. The agent gets a list of the skills with their descriptions and is told to read a skill’s SKILL.md before a task it covers. A skill’s secrets are added to the run’s environment variables, next to the automation’s own secrets. As with any workspace secret, the variable holds a placeholder, and Superlog swaps in the real value only on requests to the secret’s allowed hosts. Skills are read fresh on every turn. When you edit a skill, the next run or follow-up of every automation that uses it gets the new version. Agents also find skills in your repositories. Superlog lists SKILL.md files under .agents/skills/ and .claude/skills/, and AGENTS.md and CLAUDE.md files, from the checked-out repositories, whatever the harness.

​
Delete a skill

Open the skill and click Delete. You cannot delete a skill that an automation still uses. Remove it from those automations first. The Used by section on the skill page lists them, with an Open link to each one.

​
Limits