Skip to main content

Integrations

Agent skills

Add Agent Skills as a SKILL.md or a .zip, at personal, project, or organization scope.

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:

FieldRule
NameLowercase letters, numbers, and single hyphens; up to 64 characters
DescriptionWhat 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 itScope
Personal workspaceReusable personal default
Personal projectProject-specific entry; a matching name overrides the personal default
Organization or team projectOrganization-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.

Was this page helpful?

On this page