AIPM
Theme

Templates

SKILL.md template and examples

Templates create starter files for common AI tasks. They are only a starting point. Edit the SKILL.md, manifest, and .aipmignore file before you publish. Install the AIPM CLI once before running template commands — see the install guide.

Short answer: a SKILL.md file gives an AI agent a name, a clear purpose, and step-by-step instructions for one reusable task. Start small, test the steps, and add only the files the task needs. Every SKILL.md should start with YAML frontmatter, and name and description are required. See the SKILL.md frontmatter reference for every field and limit.

Read publishing guideExamples

blank

Blank

custom skills when you already know what files you need

aipm publish init --name @team/my-skill --template blank

Starts with

  • minimal SKILL.md
  • manifest
  • .aipmignore

code-review

Code review

pull request reviews and code quality checks

aipm publish init --name @team/review-helper --template code-review

Starts with

  • review goals
  • checklist
  • format for findings

issue-summary

Issue summary

bug triage, Sentry summaries, support tickets, and handoff notes

aipm publish init --name @team/issue-summary --template issue-summary

Starts with

  • impact
  • evidence
  • likely cause
  • next action

release-notes

Release notes

release summaries, upgrade notes, and known issues

aipm publish init --name @team/release-notes --template release-notes

Starts with

  • highlights
  • fixes
  • upgrade notes
  • known issues

Basic SKILL.md example

This small example reviews a change and reports the most important problems first.

---
name: code-review
description: Review code changes for bugs, security risks, and missing tests.
---

# Code review

1. Read the changed files and nearby tests.
2. Find problems that can change real behavior.
3. Explain each problem with a file and line number.
4. Put serious problems first.
5. Say clearly when no problem is found.

This example uses only the two required fields. For optional fields (such as license, metadata, and Claude Code's when_to_use, disable-model-invocation or paths) and which tools accept them, see the frontmatter reference. Check the AI agent file support table before sharing the skill.

Frontmatter checklist before you publish

Add frontmatter to the generated SKILL.md if it isn't there, then check:

  • name is lowercase with hyphens and matches the folder name.
  • description says what the skill does and when to use it (up to 1,024 characters).
  • There are no Claude Code-only fields if the skill will be uploaded to claude.ai.

After you choose a template

Edit the generated files, then follow the publishing guide to stage, preview, validate, and push your package.