Agent skills

Skills give the Coding Agent reusable instructions and files, such as a testing convention, a style guide, or a repository workflow. pre.dev reads skills in the Agent Skills format: a SKILL.md whose frontmatter names the skill and says when to use it.

---
name: pdf-forms
description: Fill in and read PDF forms. Use when the user mentions PDF forms, form fields, or fillable PDFs.
---

Use the repository's PDF library. Run the form tests after every change and report their result.

Add a skill

Open Agent Skills in workspace Integrations, or the same tab in a project’s Project setup. Then either:

Paste SKILL.md: paste the file’s contents.
Upload .md or .zip: a SKILL.md, or a .zip of the skill folder with SKILL.md plus scripts/, references/, or assets/.

pre.dev shows what it read before you save. Every skill needs:

Field	Rule
Name	Lowercase letters, numbers, and single hyphens; up to 64 characters
Description	What the skill does and when the agent should use it; up to 1,024 characters

A skill package can hold up to 2 MB of files. Keep long material in references/ rather than the SKILL.md body. In the CLI, /skills add <name> <instructions> adds a personal skill from one line of instructions.

Scope

Where you configure it	Scope
Personal workspace	Reusable personal default
Personal project	Project-specific entry; a matching name overrides the personal default
Organization or team project	Organization-wide entry

Choose a distinct name when the instruction should supplement an inherited entry. Reuse its name when you intend a personal project to override it.

Edit or disable

Use the entry controls to edit, toggle, or remove a skill. Apply changes before starting the work that should use them. In the CLI, /skills lists personal entries. Enter or Space toggles an entry, d removes it, and o opens workspace Integrations in the browser. Skills guide behavior. Review the actual output and checks for the task, especially when a requirement must be enforced by a test or repository policy.

Coding Agent

Projects

Work locally

Plan

Build, verify, ship

Collaborate and track

Integrations

In your app

Add a skill

Scope

Edit or disable

​Add a skill

​Scope

​Edit or disable

Add a skill

Scope

Edit or disable