View original page

Know what is inside an agent skill

Agent Skills standard

Understand the file structure before installing, editing or creating contextual agent skills with Prompeteer.

Build a skill from your taskExplore team workflows →

Illustrative SKILL.md excerpt

---
name: release-note-review
description: Review draft release notes against a supplied approved change list. Use when preparing or checking a release announcement.
---

Compare every feature claim with the supplied change list. Return unsupported statements and questions about missing rollout dates. Do not publish, change…

Read the full example →

Metadata helps an agent discover the workflow

The Agent Skills specification describes a directory containing SKILL.md. Its YAML frontmatter supplies a name and description; the Markdown body contains the instructions. Optional directories can hold references, assets or executable scripts.

A useful description says when to use the skill. Instructions explain the work and its boundaries. Check the official specification for the exact validation rules rather than inferring them from one example.

Source: Agent Skills specification

Review the trigger separately from the instructions

This small excerpt shows the distinction. It is intentionally a review-only task with no execution tools.

Illustrative SKILL.md excerpt

---
name: release-note-review
description: Review draft release notes against a supplied approved change list. Use when preparing or checking a release announcement.
---

Compare every feature claim with the supplied change list. Return unsupported statements and questions about missing rollout dates. Do not publish, change source records or assume approval.

A valid format is not a quality certificate

A structurally valid skill can still contain unsafe or inaccurate instructions. Client support for optional metadata and tools varies. Validate the package and review its behavior in the actual client.

Common questions

Is agentskills.io a Prompeteer standard?

No. Prompeteer supports the published Agent Skills format. The official specification and its maintainers are separate from Prompeteer.

Sources and review

Published by Prompeteer. See the people responsible for the product and contact the team with corrections. The linked workflow artifacts describe exactly what was checked; illustrative examples are not customer results.

Reviewed September 17, 2026

Continue your workflow

Create contextual agent skills for your work →

Create contextual agent skills and refine toward an A+ Skill Score. Build reusable SKILL.md workflows with your files and selected Memory in Prompeteer.

Build agent skills around your context →

Create contextual agent skills from your files, selected Memory and task requirements. Give individual and team workflows current sources and clear review steps.

Browse the Skills Hub →

Find reusable agent skills and review their instructions.

Choose an agent skill for the actual job →

Find skills in Prompeteer Skills Hub. Compare task fit, source, review status and client requirements before using one.

Put the workflow to work.

Build a skill from your taskExplore team workflows →


Source: https://prompeteer.ai/guides/agent-skills-standard