| title | Skills for agents and maintainers |
|---|---|
| linkTitle | Skills |
| description | Skills for agents and maintainers to use when maintaining the site. |
| weight | 22 |
| cSpell:ignore | agentskills |
This section describes skills and procedures for agents and maintainers to use when maintaining the site.
We use the term agent skill to refer to reusable actions written in
conformance to agentskills.io that can be invoked by agents or followed
manually by maintainers. We call a maintainer skill (or maintainer
procedure) a set of steps that an agent or maintainer can follow to accomplish a
specific task. Agent skills are defined in .claude/skills/. Maintainer
procedures are defined in this section.
As mentioned above, skills are defined in .claude/skills/, they are:
/draft-issue <issue-description>: draft a GitHub issue in theopentelemetry.iorepository following issue templates, contributing guidelines, and the label taxonomy./refresh-refcache-pr-fix: fetch, review and attempt to fix non-2XX URLs on the upstreamotelbot/refcache-refreshPR./resolve-refcache-conflicts <optional-pr-number>: resolvestatic/refcache.jsonmerge/rebase conflicts./review-blog-post <blog-post-path-or-pr-number>: review an OpenTelemetry blog post for front matter compliance, content conventions, GitHub link stability (gh-url-hash), spelling, and OTel terminology./review-pull-request <pr-number-or-url>: review a pull request for CI check semantics, CLA and approval-label workflow, refcache handling, locale rules, and content quality./update-i18n-drift-status [--locale locale,...] [--create-pr]: update thedrifted_from_defaultfront matter field for localized content, with optional arguments to limit which locales are processed and whether to open a PR automatically./update-old-blog-ignores: advance the year range of old blog posts excluded from lint/format checks and fix scripts./update-git-submodule <submodule>... <version|latest|HEAD>: update one or more git submodules to a target version.
Some agent chats let you invoke a skill by typing / followed by its name.
Alongside the agent skills above, hooks run automatically on certain tool
events. Configuration lives in .claude/hooks/hooks.json; hook
source lives under scripts/validate/.
- Blog front matter check: a
PreToolUsehook onWriteandEditthat blocks changes tocontent/en/blog/**/*.mdwhen the front matter is missing required fields, uses a bad date format, or introduces an H1 heading. It applies the same conventions as/review-blog-postat write-time, without waiting for review. Source:scripts/validate/front-matter-check/. Pure logic lives inindex.mjsand is covered byindex.test.mjsin the same folder (npm run test:local-toolsto run it).
See the section index below.