Skip to content

docs: introduce agentic skills for OTel.io docs workflows (#9397)#9471

Open
LoveChauhan-18 wants to merge 2 commits intoopen-telemetry:mainfrom
LoveChauhan-18:docs/agentic-skills
Open

docs: introduce agentic skills for OTel.io docs workflows (#9397)#9471
LoveChauhan-18 wants to merge 2 commits intoopen-telemetry:mainfrom
LoveChauhan-18:docs/agentic-skills

Conversation

@LoveChauhan-18
Copy link
Copy Markdown

PR Description

  • I have read and followed the Contributing docs, especially the "First-time contributing?" section.
  • This PR has content that I did not fully write myself.
  • I have the experience and knowledge necessary to understand, review, and validate all content in this PR.1

This PR introduces an agentic skills catalog in the .agents/skills directory, as proposed in #9397. These skills are structured Markdown files that enable AI coding agents to automate common documentation workflows within the opentelemetry.io repository.

Initial Skills Added:

  1. setup-localization.md: Automates the onboarding process for new localizations, including Hugo configuration updates and drafting the kickoff issue.
  2. review-content.md: Provides a standardized checklist and command set for reviewing content against the OTel style guide and site-wide linting rules.
  3. new-page-scaffold.md: Automates the creation of new documentation pages with correct frontmatter and weight calculations.

These skills are designed to improve the contributor experience for those using AI-assisted tools while maintaining compliance with project standards and automation requirements.

Fixes #9397

Footnotes

  1. Yes, I can answer maintainer questions about the content of this PR, without using AI.

…etry#9397)

Signed-off-by: Love Kumar Chauhan <lovechauhan6564@gmail.com>
@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla bot commented Mar 22, 2026

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: LoveChauhan-18 / name: Love Kumar Chauhan (8d4a32d)
  • ✅ login: otelbot[bot] / name: otelbot (87d6c60)

@otelbot-docs otelbot-docs bot added the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Mar 22, 2026
@LoveChauhan-18
Copy link
Copy Markdown
Author

Hi, just checking in — please let me know if any changes are needed from my side. Happy to update if required. Thanks!

@theletterf
Copy link
Copy Markdown
Member

+CC @vitorvasc

@vitorvasc
Copy link
Copy Markdown
Member

/fix:format

@otelbot-docs
Copy link
Copy Markdown
Contributor

otelbot-docs bot commented Mar 27, 2026

fix:format applied successfully in run 23659108977.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

[Docs] Introduce agentic skills for OTel.io docs workflows

3 participants